fix(deploy): update LITESTAR_PORT to reference Railway's injected PORT (#236)

* fix(deploy): update LITESTAR_PORT to reference Railway's injected PORT

* fix(deploy): update CMD to remove hardcoded port and use LITESTAR_PORT environment variable

Author: cofin

tools/deploy/docker/Dockerfile.distroless

@@ -213,11 +213,12 @@ WORKDIR /workspace/app
 COPY --from=runtime-prep --chown=65532:65532 /workspace/app/.venv /workspace/app/.venv
 
 # Container configuration
+# Port is configured via LITESTAR_PORT env var (defaults to 8000)
 STOPSIGNAL SIGTERM
 EXPOSE 8000
 
 ENTRYPOINT ["/usr/local/bin/tini", "--"]
-CMD ["app", "run", "--host", "0.0.0.0", "--port", "8000"]
+CMD ["app", "run", "--host", "0.0.0.0"]
 
 # Labels for container metadata (OCI spec)
 LABEL org.opencontainers.image.title="Litestar Fullstack SPA" \

tools/deploy/railway/.env.railway.example

@@ -26,9 +26,10 @@ APP_URL=https://your-app.up.railway.app
 LITESTAR_DEBUG=false
 
 # Port configuration - auto-configured by deploy.sh
-# Railway injects PORT, we map it to LITESTAR_PORT
-# Do NOT set this manually - it uses Railway variable references
-# LITESTAR_PORT=${{PORT}}
+# Railway injects PORT env var at runtime (usually 8080)
+# LITESTAR_PORT must reference it dynamically:
+#   LITESTAR_PORT=${{PORT}}
+# Do NOT hardcode a port number - use the Railway variable reference above
 
 # -----------------------------------------------------------------------------
 # Database

tools/deploy/railway/deploy.sh

@@ -300,10 +300,10 @@ ensure_environment() {
     if railway variables --kv 2>/dev/null | grep -q "SECRET_KEY="; then
         log_success "Environment variables already configured"
 
-        # Always ensure PORT is set (may need update)
-        if ! railway variables --kv 2>/dev/null | grep -q "PORT=8080"; then
-            log_info "Updating PORT configuration..."
-            railway variables --set "PORT=8080" --set "LITESTAR_PORT=8080" --skip-deploys
+        # Ensure LITESTAR_PORT references Railway's injected PORT
+        if ! railway variables --kv 2>/dev/null | grep -q 'LITESTAR_PORT=\${{PORT}}'; then
+            log_info "Setting LITESTAR_PORT to use Railway's PORT..."
+            railway variables --set 'LITESTAR_PORT=${{PORT}}' --skip-deploys
         fi
 
         # Ensure SQLAlchemy logs are quiet by default
@@ -330,6 +330,7 @@ ensure_environment() {
     SECRET_KEY=$(openssl rand -base64 32 | tr -d '=' | tr '+/' '-_')
 
     # Set essential variables
+    # Note: Railway injects PORT automatically, we reference it for LITESTAR_PORT
     railway variables --set "SECRET_KEY=${SECRET_KEY}" \
         --set "LITESTAR_DEBUG=false" \
         --set "VITE_DEV_MODE=false" \
@@ -338,8 +339,7 @@ ensure_environment() {
         --set "SQLALCHEMY_LOG_LEVEL=30" \
         --set "EMAIL_ENABLED=false" \
         --set "EMAIL_BACKEND=console" \
-        --set "PORT=8080" \
-        --set "LITESTAR_PORT=8080" \
+        --set 'LITESTAR_PORT=${{PORT}}' \
         --set 'DATABASE_URL=${{Postgres.DATABASE_URL}}' \
         --set 'SAQ_REDIS_URL=${{Redis.REDIS_URL}}' \
         --set 'APP_URL=https://${{RAILWAY_PUBLIC_DOMAIN}}' \
@@ -349,7 +349,7 @@ ensure_environment() {
     log_info "  - DATABASE_URL: linked to Postgres service"
     log_info "  - SAQ_REDIS_URL: linked to Redis service"
     log_info "  - APP_URL: auto-configured from Railway domain"
-    log_info "  - PORT/LITESTAR_PORT: 8080"
+    log_info "  - LITESTAR_PORT: uses Railway's injected PORT"
 }
 
 # -----------------------------------------------------------------------------