Skip to main content

Single Machine Deployment

This guide describes how to deploy SkillHub on a single server using Docker Compose.

Prerequisites​

  • Docker Engine 20.10+
  • Docker Compose Plugin 2.0+
  • At least 4GB available RAM
  • At least 20GB available disk space

Quick Deployment​

# 1. Clone the repository
git clone https://github.com/iflytek/skillhub.git
cd skillhub

# 2. Copy environment variable template
cp .env.release.example .env.release

# 3. Edit configuration
# Modify configuration items in .env.release, especially passwords and public URLs

# 4. Validate configuration
make validate-release-config

# 5. Start services
docker compose --env-file .env.release -f compose.release.yml up -d

Configuration​

See Configuration documentation for details.

Verify Deployment​

# Check container status
docker compose --env-file .env.release -f compose.release.yml ps

# Check backend health
curl -i http://127.0.0.1:8080/actuator/health

# Access Web UI
# Open http://localhost in browser (or configured public URL)

First Login Configuration​

  1. Login with BOOTSTRAP_ADMIN_USERNAME and BOOTSTRAP_ADMIN_PASSWORD (default admin / ChangeMe!2026)
  2. Change admin password immediately
  3. Configure enterprise SSO (optional)
  4. Create team namespaces

Next Steps​