Backend Platform Deployment Guide
This guide walks an operations engineer through deploying the SlaunchX backend platform from scratch. Follow the chapters in order for a first-time deployment; experienced operators can jump to specific sections.
Architecture
The backend platform is a containerized multi-service system running on a single Linux host via Docker.
┌─────────────────────────────────────────────────────────────────┐
│ Host: slaunchx-intra (Debian 12) │
│ │
│ ┌─ Middleware ──────────────────────────────────────────────┐ │
│ │ MySQL 8.4 Redis 7.2 RabbitMQ 3.13 MinIO │ │
│ │ (127.0.0.1) (127.0.0.1) (127.0.0.1) (127.0.0.1) │ │
│ └──────────────────────────────────────────────────────────┘ │
│ │
│ ┌─ Application Services (0.0.0.0) ─────────────────────────┐ │
│ │ │ │
│ │ app-prometheus ──── Core API gateway + business logic │ │
│ │ support-email ───── Email sending service │ │
│ │ support-file ────── File upload/download (MinIO) │ │
│ │ support-schedule ── Scheduled tasks + event consumer │ │
│ │ partner-slash ───── Slash platform integration │ │
│ │ partner-stripe ──── Stripe payment integration │ │
│ │ support-tron ────── TRON blockchain wallet │ │
│ │ support-solana ──── Solana blockchain wallet │ │
│ │ │ │
│ └───────────────────────────────────────────────────────────┘ │
│ │
│ Docker Network: slaunchx-intra (172.30.0.0/24) │
└─────────────────────────────────────────────────────────────────┘Service Dependencies
app-prometheus ──→ MySQL, Redis, RabbitMQ, MinIO
support-email ───→ Redis, SMTP (external)
support-file ────→ MinIO
support-schedule → RabbitMQ, MySQL
partner-slash ───→ Slash API (external)
partner-stripe ──→ Stripe API (external)
support-tron ────→ TRON RPC (external), MySQL
support-solana ──→ Solana RPC (external), MySQLapp-prometheus is the core service — deploy it first after middleware. All other services are optional depending on which features you need.
Environment Matrix
| Environment | App Ports | Middleware Ports | Profile | Use Case |
|---|---|---|---|---|
| dev | 33xxx | 35xxx/36xxx | dev | Local development (LAN-accessible) |
| test | 18xxx | 18xxx | test | Integration testing |
| alpha | 19xxx | 19xxx | alpha | Staging / pre-production |
| product | 29xxx | 29xxx | product | Production |
Port suffix per module:
| Suffix | Module |
|---|---|
| 020 | app-prometheus |
| 030 | support-email |
| 040 | support-file |
| 050 | support-schedule |
| 060 | support-tron-wallet |
| 070 | support-solana-wallet |
| 101 | partner-slash |
| 102 | partner-stripe |
Example: app-prometheus in test = port 18020, in alpha = port 19020.
Reading Order
| # | Chapter | What You'll Do |
|---|---|---|
| 1 | Prerequisites | Verify server, install tools, create Docker network |
| 2 | Middleware Setup | Deploy MySQL, Redis, RabbitMQ, MinIO |
| 3 | Build and Registry | Build Java app, create Docker images, set up private registry |
| 4 | Application Configuration | Understand config layers, prepare env files |
| 5 | Deploy Services | Start all application containers in dependency order |
| 6 | Health Check and Verification | Verify every service is running correctly |
| 7 | Backup and Maintenance | Set up backups, log rotation, upgrade procedures |
| 8 | Reference | Port tables, naming conventions, command cheat sheet |