genlayerlabs 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