Python · deploy guide

Deploy Django on DockHive

Django served by gunicorn. DockHive recognises it from a manage.py file or a django dependency, so you don't write a Dockerfile or a deploy config. Drone builds it, fixes failed builds and puts it live with HTTPS.

Deploy with Drone Start free

01

Deploy with Drone (zero config)

Drone is DockHive's AI deploy agent. It reads the repository, works out the stack, writes the Dockerfile, picks the port and health check and lists the env vars your Django app needs.

  1. 1 Push to GitHubPush the project to a GitHub repository. No Dockerfile or deploy config needed.
  2. 2 Pick the repoIn the DockHive console, open App Hosting and choose the repository.
  3. 3 Deploy with DroneDrone builds it. If the build or health check fails it reads the logs, fixes the build setup and retries, then goes live on <app>.dockhive.app with HTTPS.

Drone saves the working setup, so every push to the repository redeploys automatically. How Drone works

02

Deploy from the terminal

Install the hivepod CLI, sign in once, then run hivepod deploy in the project folder. It uploads the folder (without .git, node_modules, virtualenvs or secrets) and Drone builds it.

macOS and Linux
$ curl -fsSL https://dockhive.io/install.sh | sh
Windows (PowerShell)
> irm https://dockhive.io/install.ps1 | iex
Sign in
$ hivepod login
In your Django folder
$ hivepod deploy

Deploying the same folder again updates the same app. Set variables on the way with hivepod deploy --env KEY=value.

03

Deploy from your AI agent (MCP)

The CLI includes an MCP server. Add it to Claude Code, then ask your agent to "deploy this to DockHive". The agent calls the deploy tool and hands back the live URL, or Drone's summary and any missing env vars if something needs your input.

Claude Code
$ claude mcp add dockhive -- hivepod mcp

Using Claude Desktop, Cursor or Windsurf? Set up the DockHive MCP server.

04

What DockHive detects for Django

Detection reads your files; it never runs your code. Recognised by a manage.py file or a django dependency. These are the defaults; DockHive derives the exact commands from your repository (lockfile, scripts, entry module).

Default port
8000
Install
pip install -r requirements.txt
Build
python manage.py collectstatic --noinput
Start
gunicorn <project>.wsgi:application
  • Finds your wsgi.py (the one calling get_wsgi_application()) and serves it with gunicorn on 0.0.0.0:$PORT with 2 workers.
  • gunicorn is installed for you when it is not in your dependencies.
  • collectstatic runs during the build when manage.py exists.
  • Recognised by requirements.txt, pyproject.toml, Pipfile, setup.py or manage.py.
  • Python version: read from .python-version or runtime.txt (3.9 to 3.13; 3.12 when unset).
  • Install: requirements.txt when present; otherwise poetry.lock (Poetry), uv.lock (uv), Pipfile (Pipenv) or pip install . for pyproject.toml/setup.py.
  • psycopg2 (not -binary) and mysqlclient get the system packages they need to compile.
  • Generated images set PORT, listen on 0.0.0.0:$PORT and run as a non-root user wherever the runtime allows. Nothing is written back to your repository.
  • Monorepo? When the repository root isn't an app, DockHive looks one level down (app, web, frontend, backend, server, api, src, site, client first).

05

Environment variables and custom domains

Environment variables

Drone spots the variables your app reads. Set the values in the console, with --env on hivepod deploy, or through your agent. Values are write-only. Secrets and .env files are never uploaded.

Custom domains

Every app gets <app>.dockhive.app with HTTPS. To use your own domain, add it to the app and point a CNAME record at DockHive; the Let's Encrypt certificate is issued automatically.

Django on DockHive: FAQ

Do I need a Dockerfile to deploy Django on DockHive?

No. DockHive recognises a Django app (from a manage.py file or a django dependency) and generates the build itself. If your app directory already has a Dockerfile, DockHive builds that instead.

Which port does a Django app use on DockHive?

The default for Django is 8000. DockHive sets the PORT environment variable and starts the app on 0.0.0.0:$PORT, so code that reads PORT works as-is.

Do I need gunicorn in requirements.txt for Django?

No. If gunicorn is not in your dependencies, DockHive installs it and serves your project with gunicorn <project>.wsgi:application on port 8000 by default.

How do I set environment variables for my Django app?

Drone spots the variables your app needs. Set the values in the DockHive console, with hivepod deploy --env KEY=value, or from your AI agent over MCP. Secrets and .env files are never uploaded.

Does every push redeploy my Django app?

Yes. After the first successful deploy Drone saves the working setup, and every push to the connected GitHub repository redeploys automatically.

More deploy guides

Ship your Django app today

Start on the Free Tier. The Developer Plan is $3/month. See pricing

Deploy with Drone Read the docs