Skip to content

Local deployment with podman

Sajid Ali edited this page May 9, 2025 · 1 revision

Assuming you have podman running in rootless mode, to deploy locally, follow these steps:

  • collect static files with: uv run manage.py collectstatic
  • build container with: podman build --tag "coldfront:debugpy" -f Containerfile.debugpy
  • start a pod with: podman pod create --name=django-caddy-gunicorn -p 8888:80 -p 5678:5678
  • start caddy container within the pod with: podman run -d -v (pwd)/deploy/local/Caddyfile:/etc/caddy/Caddyfile -v (pwd)/static_root:/srv/static --pod=django-caddy-gunicorn caddy:alpine
  • start gunicorn container (with debugpy enabled) with: podman run -d --pod=django-caddy-gunicorn coldfront:debugpy And now you can head to localhost:8888 (http, not https) to access the website.

With debugpy, you can set breakpoints within VSCode for easier debugging using the debug adapter protocol.

Clone this wiki locally