setup

Setup and launch the entire GenLayer Studio development environment.

Prerequisites

• Docker installed and running

Setup Steps

1. Verify Docker is Running

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

2. Start All Services

docker 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)

genlayer init

Or manually:

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

4. Verify Services

# 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

| Command | Description | |---------|-------------| | docker compose up -d | Start all services (detached) | | docker compose down | Stop all services | | docker compose down -v | Stop and clear all data | | docker compose logs -f | Tail all logs | | docker compose logs -f backend | Tail backend logs | | docker compose restart backend | Restart specific service |

Alternative: GenLayer CLI

If you have the GenLayer CLI installed:

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

Troubleshooting

Port Already in Use

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

# Or use different ports in .env

Database Connection Issues

# Check database is ready
docker compose logs db

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

Container Won't Start

# Check logs for specific service
docker compose logs backend

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