djust-deploy CLI

The deploy CLI manages deployments to djustlive.com, the managed hosting platform for djust applications.

Installation

The CLI ships with djust. Its click and requests dependencies are base dependencies:

pip install djust

pip install djust[deploy] still works as a no-op alias for older install scripts. Two entry points are available: djust deploy ... (recommended) and the standalone djust-deploy .... djust deploy login, djust deploy logout and djust deploy status work as written; for deploying, see Which deploy command runs. The examples below use the standalone djust-deploy <command> form, which exposes every command and option directly.

Authentication

Login

djust-deploy login

Opens your browser to sign in to djustlive.com (OAuth with PKCE, using a local loopback callback). When you approve, the CLI stores an access token and a refresh token at ~/.djustlive/credentials (file mode 0600). If the refresh token has expired, the next deploy re-launches the browser flow.

Logout

djust-deploy logout

Revokes the server session and removes the local credentials file.

Commands

Global options

• --server URL: the djustlive server to talk to (default https://djustlive.com). Also read from the DJUST_SERVER environment variable. Pass it before the command name, e.g. djust-deploy --server URL deploy-dir. With djust deploy, set DJUST_SERVER instead.

Which deploy command runs

djust deploy picks the command for you:

djust deploy                      # deploy-dir: upload the current directory
djust deploy <project-slug>       # deploy-dir with an explicit slug
djust deploy <slug> --from-git    # deploy: git-based deploy (the flag may come first)

deploy-dir

Deploy from a local directory (no git required). The CLI tarballs the directory, uploads it, and reports the deployment status:

djust-deploy deploy-dir [<project-slug>] [--dir DIR] [--yes] [--no-create]

• --dir DIR: directory to deploy (default: the current directory).
• --yes / -y: auto-accept all prompts (CI and scripted use).
• --no-create: fail if the project doesn't already exist, instead of offering to create it.

deploy

Trigger a git-based production deployment for a project:

djust-deploy deploy [<project-slug>] [--yes] [--no-create]

Before deploying, the CLI verifies that your git working tree is clean. If you have uncommitted changes, the deploy is aborted — commit or stash first. It also runs a preflight settings check that warns (never blocks) about settings that break the platform's environment contract.

--yes and --no-create behave as for deploy-dir. Build logs are streamed to stdout in real time.

Project slug resolution

For both deploy commands the slug is optional. When you omit it, the CLI uses [tool.djust.deploy].project from pyproject.toml, and otherwise prompts for it (offering to save the answer to pyproject.toml). Both commands also log you in first if needed, and offer to create the project on the server if it doesn't exist yet.

status

Check the current deployment state:

# All projects
djust-deploy status

# Specific project
djust-deploy status <project-slug>

Returns JSON with deployment details (state, timestamps, etc.).

Credential Storage

Credentials are stored at ~/.djustlive/credentials as JSON:

{
  "auth_scheme": "bearer",
  "access_token": "...",
  "refresh_token": "...",
  "expires_at": 1760000000,
  "email": "you@example.com",
  "server_url": "https://djustlive.com"
}

The directory is created with mode 0700 and the file with mode 0600 (owner-only access).