Deployment

Prerequisites

• Docker & Docker Compose v2
• Domain with DNS configured
• SSL certificates (Traefik handles via Let's Encrypt)

Quick Start

git clone https://github.com/heichaowo/moenet-core.git
cd moenet-core
cp .env.example .env
vim .env  # Configure all required values

docker compose up -d

Services

Service	Port	Description
api	3000	Hono.js REST API
bot	8443	Telegram Bot (webhook)
postgres	5432	PostgreSQL database
redis	6379	Session/cache store
traefik	80/443	Reverse proxy with TLS

Updating

cd /opt/moenet-core
git pull origin main
docker compose up -d --build

CI/CD

Push to main triggers:

1. Run tests
2. Build Docker images
3. Push to GHCR
4. Deploy to server (if secrets configured)

Required GitHub Secrets:

Secret	Description
DEPLOY_HOST	Server hostname
DEPLOY_USER	SSH username
DEPLOY_KEY	SSH private key

Backup & Restore

PostgreSQL

# Backup
docker exec moenet-postgres pg_dump -U moenet moenet > backup.sql

# Restore
docker exec -i moenet-postgres psql -U moenet moenet < backup.sql

Redis

# Backup
docker cp moenet-redis:/data/dump.rdb ./redis-backup.rdb

# Restore
docker cp ./redis-backup.rdb moenet-redis:/data/dump.rdb
docker restart moenet-redis