Local Setup

# Via docker exec
docker exec labrinth-postgres psql -U labrinth -d labrinth

# Run a query
docker exec labrinth-postgres psql -U labrinth -d labrinth -c "SELECT COUNT(*) FROM projects;"

# Using local psql client
psql postgresql://labrinth:labrinth@localhost:5432/labrinth

# Run migrations (from apps/labrinth)
cd apps/labrinth
cargo sqlx migrate run

# Create new migration
cargo sqlx migrate add create_my_table

# Connect to Redis CLI
docker exec -it labrinth-redis redis-cli

# Example commands
> KEYS *
> GET session:abc123
> HGETALL user:456

# Connect to ClickHouse client
docker exec -it labrinth-clickhouse clickhouse-client

# Use staging database
USE staging_ariadne;

# Query analytics
SELECT COUNT(*) FROM downloads;

CREATE TABLE IF NOT EXISTS staging_ariadne.downloads (
    version_id String,
    timestamp DateTime,
    ip String,
    user_agent String
) ENGINE = MergeTree()
ORDER BY timestamp;

# Check health
curl http://localhost:7700/health

# List indexes
curl http://localhost:7700/indexes \
  -H "Authorization: Bearer modrinth"

# Manually trigger reindex (from Labrinth API)
curl -X POST http://localhost:8000/_internal/search/reindex \
  -H "Authorization: Bearer YOUR_ADMIN_KEY"

# Test PDF generation
curl --request POST \
  --url http://localhost:13000/forms/chromium/convert/url \
  --form url=https://modrinth.com \
  --output test.pdf

# Check health endpoint
curl http://localhost:8000/health

# Browse API docs
open http://localhost:8000/docs

# Database
DATABASE_URL=postgres://labrinth:labrinth@localhost/labrinth

# Redis
REDIS_URL=redis://localhost:6379

# ClickHouse
ANALYTICS_URL=http://localhost:8123
ANALYTICS_DATABASE=staging_ariadne

# Meilisearch
MEILISEARCH_ADDR=http://localhost:7700
MEILISEARCH_KEY=modrinth

# S3 (local development - optional)
# S3_URL=http://localhost:9000  # If using MinIO
# S3_BUCKET_NAME=modrinth

# Email (Mailpit)
SMTP_HOST=localhost
SMTP_PORT=1025

# Auth (for OAuth - use test credentials)
GITHUB_CLIENT_ID=your_test_client_id
GITHUB_CLIENT_SECRET=your_test_secret

# Internal API key (for admin endpoints)
ADMIN_KEY=feedbeef

# From root directory
cd apps/frontend
cp .env.local .env

# Edit .env if needed to point to local Labrinth
# NUXT_PUBLIC_LABRINTH_URL=http://localhost:8000

cd ../..
pnpm web:dev

# From root directory
cd packages/app-lib
cp .env.local .env

cd ../..
pnpm app:dev

# Stop services
docker compose down -v

# Remove all data
rm -rf docker-volumes/  # If you have local volumes

# Start services
docker compose up -d

# Run migrations
cd apps/labrinth
cargo sqlx migrate run

-- Connect to PostgreSQL
docker exec -it labrinth-postgres psql -U labrinth -d labrinth

-- Create test user
INSERT INTO users (id, username, email, created)
VALUES ('local_1', 'testuser', '[email protected]', NOW());

-- Create test project
INSERT INTO projects (id, slug, title, description, published)
VALUES ('local_proj_1', 'test-mod', 'Test Mod', 'A test mod', NOW());

# Authenticate (requires GitHub OAuth setup)
curl -X POST http://localhost:8000/v3/project \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -d '{
    "title": "Test Mod",
    "slug": "test-mod",
    "description": "A test mod",
    "project_type": "mod",
    "categories": ["technology"],
    "license_id": "MIT"
  }'

docker exec labrinth-postgres pg_dump -U labrinth labrinth > backup.sql

cat backup.sql | docker exec -i labrinth-postgres psql -U labrinth -d labrinth

# Start with Delphi profile
docker compose --profile with-delphi up -d

docker compose --profile sharded-meilisearch up -d

docker compose --profile with-labrinth up -d

# Check service logs
docker compose logs postgres_db
docker compose logs redis
docker compose logs clickhouse

# Check all logs
docker compose logs -f

ports:
  - '127.0.0.1:5433:5432'  # Use 5433 instead of 5432

DATABASE_URL=postgres://labrinth:labrinth@localhost:5433/labrinth

# Verify PostgreSQL is running and healthy
docker compose ps postgres_db

# Check connection
psql postgresql://labrinth:labrinth@localhost:5432/labrinth -c "SELECT 1;"

# Check Meilisearch health
curl http://localhost:7700/health

# List indexes
curl http://localhost:7700/indexes -H "Authorization: Bearer modrinth"

# Trigger reindex from Labrinth
curl -X POST http://localhost:8000/_internal/search/reindex \
  -H "Authorization: Bearer feedbeef"

# Install sccache (compilation cache)
cargo install sccache

# Add to ~/.cargo/config.toml
[build]
rustc-wrapper = "sccache"

# Or use mold linker (Linux)
sudo apt install mold
export RUSTFLAGS="-C link-arg=-fuse-ld=mold"

# Clean up unused containers and images
docker system prune -a

# Remove volumes
docker volume prune

# 1. Start services
docker compose up -d

# 2. Start Labrinth (in one terminal)
cd apps/labrinth
cargo run

# 3. Start frontend (in another terminal)
pnpm web:dev

# 4. Make changes and test

# 5. When done, stop services
docker compose down

cargo install cargo-watch

# Auto-restart on file changes
cargo watch -x 'run -p labrinth'

# Docker service logs
docker compose logs -f postgres_db
docker compose logs -f meilisearch0

# Labrinth logs (if running with cargo)
# Already visible in terminal

# Frontend logs
# Already visible in terminal running pnpm web:dev

# Edit docker-compose.yml to add environment variables:
environment:
  - POSTGRES_SHARED_BUFFERS=256MB
  - POSTGRES_WORK_MEM=16MB
  - POSTGRES_MAINTENANCE_WORK_MEM=64MB

redis:
  command: redis-server --maxmemory 256mb --maxmemory-policy allkeys-lru

clickhouse:
  environment:
    - CLICKHOUSE_MAX_MEMORY_USAGE=4000000000  # 4GB