Console Commands¶

All management commands are run inside the container via docker exec:

docker exec -it comaney-web-1 python manage.py <command> [args]

Replace comaney-web-1 with the name shown by docker compose ps if yours differs.

User management¶

create_user¶

Creates a confirmed, active user account without going through the registration flow.

python manage.py create_user <email> [-p <password>]

If -p is omitted, the password is prompted interactively (with confirmation). The account is immediately usable: no email confirmation step is required.

# Interactive (recommended on shared terminals):
docker exec -it comaney-web-1 python manage.py create_user alice@example.com

# Non-interactive:
docker exec -it comaney-web-1 python manage.py create_user alice@example.com -p "SecurePass1"

Optional: --ai-config KEY=VALUE (repeatable) sets one of the user's own AI settings for the active AI provider, for example their own API key:

docker exec -it comaney-web-1 python manage.py create_user alice@example.com --ai-config api_key=sk-...

The keys are the provider's user settings (api_key for Claude). An unknown key, a value the provider rejects, or no active AI provider (AI_PROVIDER) stops the command without creating the account.

Exits with an error if the email is already in use or the password is empty.

set_user_password¶

Updates the password for an existing account.

python manage.py set_user_password <email> [-p <password>]

If -p is omitted, the new password is prompted interactively (with confirmation).

docker exec -it comaney-web-1 python manage.py set_user_password alice@example.com

Exits with an error if no account with that email exists.

remove_user_2fa¶

Removes every second-factor method (authenticator app entries and security keys) for a user. Use this when a user is locked out after losing every method and their recovery code.

python manage.py remove_user_2fa <email>

Deletes all of the user's TOTP and security-key factors and clears the recovery code hash. The user can then log in with their password alone and set up 2FA again from their profile. The command is idempotent: running it when 2FA is already off prints a notice and exits cleanly.

docker exec -it comaney-web-1 python manage.py remove_user_2fa alice@example.com

Exits with an error if no account with that email exists.

delete_user¶

Permanently deletes a user account and all associated data (expenses, categories, tags, recurring expenses, dashboard cards).

python manage.py delete_user <email> [--yes]

Without --yes, the command asks for confirmation before proceeding. Type yes to confirm; anything else aborts. This operation is irreversible.

# Interactive:
docker exec -it comaney-web-1 python manage.py delete_user alice@example.com

# Skip confirmation (for scripts):
docker exec -it comaney-web-1 python manage.py delete_user alice@example.com --yes

Exits with an error if no account with that email exists.

Cron commands¶

These are intended to run on a schedule. See Cron Jobs for the recommended cron entries.

run_cron¶

Runs all scheduled maintenance tasks in sequence: scheduled expense generation, auto-settle, allowance transitions, expense notifications, the demo user reset check, and purge_inactive_ai_config.

python manage.py run_cron [--year YEAR --month MONTH]

The optional --year and --month flags override the current financial month for all users, which is useful for testing or manual backfills.

purge_inactive_ai_config¶

Deletes every user's saved AI settings that belong to an AI provider other than the active one (for example their old Claude key after switching AI_PROVIDER to another provider). The active provider's settings are kept.

python manage.py purge_inactive_ai_config

Does nothing while no AI provider is active (AI_PROVIDER unset or none), so saved settings survive an upgrade until AI_PROVIDER is set. Runs automatically at container start (after the database migrations) and as part of run_cron.

reset_trial_budgets¶

Resets the AI trial usage counter for every user. Run once per month.

python manage.py reset_trial_budgets