---

name: setup description: Setup and launch GenLayer Studio with Docker Compose

Setup GenLayer Studio

Setup and launch the entire GenLayer Studio development environment.

Prerequisites

• Docker installed and running

Setup Steps

1. Verify Docker is Running

Copydocker info > /dev/null 2>&1 && echo "Docker is running" || echo "Docker is not running"

2. Start All Services

Copydocker compose up -d

This starts:

• Frontend: Vue 3 app on http://localhost:8080
• Backend: Flask JSON-RPC API on http://localhost:4000
• PostgreSQL: Database on port 5432
• WebDriver: Selenium service for contract sandboxing

3. Initialize Database (first time only)

Copygenlayer init

Or manually:

Copydocker exec -it genlayer-studio-backend-1 alembic upgrade head

4. Verify Services

Copy# Check all containers are running
docker compose ps

# Test backend health
curl -s http://localhost:4000/health | jq .

# Open frontend
open http://localhost:8080

Common Commands

Alternative: GenLayer CLI

If you have the GenLayer CLI installed:

Copygenlayer up      # Start all services
genlayer init    # Initialize database
genlayer down    # Stop all services

Troubleshooting

Port Already in Use

Copy# Find what's using port 8080
lsof -i :8080

# Or use different ports in .env

Database Connection Issues

Copy# Check database is ready
docker compose logs db

# Reset database
docker compose down -v && docker compose up -d

Container Won't Start

Copy# Check logs for specific service
docker compose logs backend

# Rebuild containers
docker compose build --no-cache
docker compose up -d