setup

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

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