Run
This page is the single entry point for running DaxPay — helping you pick the right approach for your scenario, listing prerequisites, and showing how to verify a successful start.
Ways to Run
| Approach | Best for | Notes |
|---|---|---|
| Docker Compose | Fastest tryout, local integration | One command brings up PostgreSQL / Redis / Artemis / main app / channel sub-app. Recommended for first-time users. |
| Source Build | Customization, tailored deployment | Clone and compile with mvnd when you need to modify the source. |
| Configuration | Tuning Profile, ports, DB, secrets | Required reading for production deployment and credential injection. |
Recommended path
New to DaxPay? Start with Docker Compose — the full stack is up and running in minutes.
Prerequisites
| Requirement | Version | Notes |
|---|---|---|
| JDK | 25+ | Java runtime (not needed for containerized deploy — bundled in image) |
| mvnd | Latest | Maven Daemon, speeds up source compilation |
| Node.js | ^22.13.0 || ^24.0.0 | Frontend build |
| pnpm | >=10.0.0 | Package manager (required; npm/yarn disabled) |
| PostgreSQL | 14+ | Primary database |
| Redis | 7+ | Distributed cache |
| Apache Artemis | Latest | JMS broker for delayed payment notifications |
Create the database in advance (UTF8, public schema). For naming conventions and details see the Build page.
App Ports
| App | Port | Health check |
|---|---|---|
| Main app dax-pay-open | 9999 | http://127.0.0.1:9999/actuator/health |
| Channel sub-app dax-pay-channel-one | 20100 | http://127.0.0.1:20100/actuator/health |
| Channel sub-app dax-pay-channel-two | 20200 | http://127.0.0.1:20200/actuator/health |
| Admin Web (dev) | 6999 | — |
| Merchant Web (dev) | 7999 | — |
| H5 (dev) | 9500 | — |
| Mini-App Admin (H5 dev) | 9000 | — |
| Docs (dev) | 5173 | — |
Fastest Path: Docker Compose
Once your .env is ready (DB / Redis / Artemis / RSA / AES credentials — see Configuration):
bash
# Bring up all services
docker compose --env-file .env up -d
# Tail main app logs
docker compose logs -f daxpay-openFor the full docker-compose.yml template see Docker.
Verify
bash
# Main app health, expect {"status":"UP"}
curl http://localhost:9999/actuator/health
# Channel sub-app
curl http://localhost:20100/actuator/healthOnce started, visit:
- The main app console prints
应用 'dax-pay-open' 运行成功! - API docs (dev):
http://127.0.0.1:9999/swagger-ui/index.html - Admin (dev):
http://127.0.0.1:6999 - Merchant (dev):
http://127.0.0.1:7999 - H5 (dev):
http://127.0.0.1:9500
Next Steps
- Build: source compilation and bare-metal startup details
- Configuration: Profile switching, database, Redis, secrets, and production env vars
- Docker: image building and the full docker-compose template