Skip to main content

Platform Setup (5 Minutes)

Platform Setup (5 Minutes)

Get the LLM Platform running locally in under 5 minutes using DDEV.

Prerequisites

  • macOS, Linux, or Windows with WSL2
  • 8 GB RAM minimum
  • 20 GB free disk space
  • Internet connection

Step 1: Install DDEV (1 minute)

macOS:

brew install ddev/ddev/ddev

Linux (Ubuntu/Debian):

curl -fsSL https://raw.githubusercontent.com/ddev/ddev/master/scripts/install_ddev.sh | bash

Verify:

ddev version
# Should show v1.22.0+

Step 2: Clone Repository (30 seconds)

# Create workspace
mkdir -p ~/Sites/LLM && cd ~/Sites/LLM

# Clone platform
git clone https://gitlab.com/blueflyio/agent-platform/demos/llm-platform-demo.git llm-platform
cd llm-platform

Step 3: Install Dependencies (2 minutes)

# Install DDEV addons
./infrastructure/ddev-addons/install-addons.sh

# Start DDEV
ddev start

# Install PHP dependencies
ddev composer install

Step 4: Configure Site (1 minute)

# Import configuration
ddev drush cim -y

# Clear cache
ddev drush cr

# Set admin password
ddev drush user:password admin "admin"

Step 5: Access Platform (10 seconds)

# Open in browser
ddev launch

# Or manually: https://llm-platform.ddev.site

Default credentials:

  • Username: admin
  • Password: admin

Verify Installation

# Check platform status
ddev platform status

# Expected output:
#  Drupal running
#  PostgreSQL connected
#  Redis running
#  Qdrant vector database ready

What's Next?

Troubleshooting

Port conflict (8080 in use):

ddev stop
ddev config --router-http-port=8888
ddev start

Composer install fails:

ddev composer clear-cache
ddev composer install --no-cache

Database connection error:

ddev restart
ddev drush status

Time to complete: 5 minutes Next: Build a Workflow