Harness AI Dokploy Deployment: Production Stack Guide

#!/usr/bin/env bash
set -euo pipefail

API_HOST="${API_HOST:-0.0.0.0}"
API_PORT="${API_PORT:-8000}"
API_EXECUTION_QUEUE="${API_EXECUTION_QUEUE:-executions}"

# Fail fast if the broker URL is missing — silent defaulting would mask
# a misconfigured deploy until the worker crashes on first connection.
: "${REDIS_URL:?REDIS_URL must be set (e.g. redis://redis:6379/0)}"

UVICORN_PID=""
RQ_PID=""

cleanup() {
    local sig="$1"
    echo "[entrypoint] received ${sig}; forwarding to children"
    if [ -n "${UVICORN_PID}" ] && kill -0 "${UVICORN_PID}" 2>/dev/null; then
        kill -TERM "${UVICORN_PID}" 2>/dev/null || true
    fi
    if [ -n "${RQ_PID}" ] && kill -0 "${RQ_PID}" 2>/dev/null; then
        kill -TERM "${RQ_PID}" 2>/dev/null || true
    fi
}

trap 'cleanup SIGTERM' SIGTERM
trap 'cleanup SIGINT'  SIGINT

echo "[entrypoint] starting uvicorn on ${API_HOST}:${API_PORT}"
uvicorn runtime.api.main:app --host "${API_HOST}" --port "${API_PORT}" &
UVICORN_PID=$!

echo "[entrypoint] starting rq worker on queue '${API_EXECUTION_QUEUE}'"
rq worker "${API_EXECUTION_QUEUE}" --url "${REDIS_URL}" &
RQ_PID=$!

echo "[entrypoint] uvicorn_pid=${UVICORN_PID} rq_pid=${RQ_PID}"

# wait -n returns as soon as EITHER child exits and yields that child's
# exit status. The script propagates that exact code to Docker so the
# container flips to (unhealthy) if either process dies.
wait -n
WAIT_EXIT=$?

echo "[entrypoint] a child exited with status ${WAIT_EXIT}; terminating the surviving child"

if [ -n "${UVICORN_PID}" ] && kill -0 "${UVICORN_PID}" 2>/dev/null; then
    kill -TERM "${UVICORN_PID}" 2>/dev/null || true
fi
if [ -n "${RQ_PID}" ] && kill -0 "${RQ_PID}" 2>/dev/null; then
    kill -TERM "${RQ_PID}" 2>/dev/null || true
fi

exit "${WAIT_EXIT}"

# Graceful shutdown only
docker compose -f infra/compose/docker-compose.prod.yml down

# Graceful shutdown + wipe named volumes (destructive — drops all data)
docker compose -f infra/compose/docker-compose.prod.yml down -v