API reference, task workflow, deployment docs, project management rules. Ensures consistent task tracking and documentation.
58 lines
2.1 KiB
Markdown
58 lines
2.1 KiB
Markdown
# Dokploy Deployment
|
|
|
|
Hammer Dashboard is deployed via Docker Compose on Dokploy (cloud: app.dokploy.com).
|
|
|
|
## Quick Deploy
|
|
|
|
```bash
|
|
curl -s -X POST "https://app.dokploy.com/api/trpc/compose.deploy" \
|
|
-H "x-api-key: cFnoojfvEdZXzDvJDGTtoyIcRVbMajtaWOhTrreWElZkIvtuFTJbMZXkzitmclal" \
|
|
-H "Content-Type: application/json" \
|
|
-d '{"json":{"composeId":"kBdwrcZodIRyNIvQ-wrzG"}}'
|
|
```
|
|
|
|
## Check Deploy Status
|
|
|
|
```bash
|
|
curl -s "https://app.dokploy.com/api/trpc/deployment.allByCompose?input=%7B%22json%22%3A%7B%22composeId%22%3A%22kBdwrcZodIRyNIvQ-wrzG%22%7D%7D" \
|
|
-H "x-api-key: cFnoojfvEdZXzDvJDGTtoyIcRVbMajtaWOhTrreWElZkIvtuFTJbMZXkzitmclal"
|
|
```
|
|
|
|
## Update Environment Variables
|
|
|
|
```bash
|
|
curl -s -X POST "https://app.dokploy.com/api/trpc/compose.update" \
|
|
-H "x-api-key: cFnoojfvEdZXzDvJDGTtoyIcRVbMajtaWOhTrreWElZkIvtuFTJbMZXkzitmclal" \
|
|
-H "Content-Type: application/json" \
|
|
-d '{"json":{"composeId":"kBdwrcZodIRyNIvQ-wrzG","env":"KEY=VALUE\nKEY2=VALUE2"}}'
|
|
```
|
|
|
|
## Update Compose File
|
|
|
|
```bash
|
|
curl -s -X POST "https://app.dokploy.com/api/trpc/compose.update" \
|
|
-H "x-api-key: cFnoojfvEdZXzDvJDGTtoyIcRVbMajtaWOhTrreWElZkIvtuFTJbMZXkzitmclal" \
|
|
-H "Content-Type: application/json" \
|
|
-d '{"json":{"composeId":"kBdwrcZodIRyNIvQ-wrzG","composeFile":"..."}}'
|
|
```
|
|
|
|
## Stack
|
|
|
|
- **db**: Postgres 16 Alpine
|
|
- **backend**: Elysia + Bun + Drizzle ORM (builds from git.infra.nkode.tech/hammer/hammer-queue#main:backend)
|
|
- **frontend**: React + Vite + Tailwind (builds from same repo #main:frontend)
|
|
- Backend runs `db:push` on startup (auto-migrates schema changes)
|
|
- Domain: dash.donovankelly.xyz
|
|
- Git repo: https://git.infra.nkode.tech/hammer/hammer-queue.git
|
|
|
|
## Environment Variables
|
|
|
|
- `POSTGRES_USER`, `POSTGRES_PASSWORD`, `POSTGRES_DB`
|
|
- `API_BEARER_TOKEN` — bearer token for task API
|
|
- `BETTER_AUTH_SECRET`, `BETTER_AUTH_URL` — BetterAuth config
|
|
- `COOKIE_DOMAIN` — `.donovankelly.xyz`
|
|
- `CLAWDBOT_HOOK_URL` — webhook endpoint for task activation notifications
|
|
- `CLAWDBOT_HOOK_TOKEN` — gateway hook auth token
|
|
- `GATEWAY_WS_URL` — WebSocket relay to Clawdbot gateway
|
|
- `GATEWAY_WS_TOKEN` — gateway auth token
|