Skip to main content
Flask + arq . Self-hosted . Open source

Flask arq Dashboard

Run arq inside a Flask app and you have working background jobs. Run arq with z4j and you also have a dashboard, persistent history, the task controls this adapter can execute safely, scheduler integration, RBAC with invitations, and a tamper-evident audit log. z4j is one container or one Python process; the agent is one pip extra in your existing Flask venv.

Flask + arq works the same way every other Flask + queue combo works under z4j: pip install the framework adapter with the engine extra, set four environment variables, restart your worker. z4j stays where you put it (homelab, on-prem, or cloud); the agent always reaches out.

Install z4j Flask integration details arq adapter details
install

Install z4j alongside Flask + arq

1. Install the brain

bash 
pip install z4j && z4j serve

First boot prints a setup URL to stderr. Open it, create the first admin, and mint a token + HMAC secret for this agent.

2. Add the agent to your Flask venv

bash 
pip install z4j-flask[arq]

3. Wire it into Flask

python 
from flask import Flask
from z4j_flask import Z4J

app = Flask(__name__)
app.config.from_prefixed_env("Z4J_")
z4j = Z4J(app)

What you get

  • Persistent arq task history in Postgres or SQLite
  • Adapter-advertised controls: submit_task, cancel_task (Job.abort)
  • Scheduler integration via arq cron; available controls depend on that scheduler adapter
  • RBAC with invitations and password reset
  • HMAC-chained tamper-evident audit log
  • Notifications: email, Slack, Telegram, webhook
License

z4j-flask and z4j-arq are Apache 2.0. Importing them into your Flask app does not affect your application's licensing. z4j is AGPL-3.0-or-later, isolated in its own process.

arq actions exposed

What the dashboard can actually do

Native actions

  • submit_task
  • cancel_task (Job.abort)

Event capture

attach_to_worker_settings() chains onto on_job_start / on_job_end; it must be attached for lifecycle capture.

Reconciliation

arq.jobs.Job.status() + result_info(): clean deferred/queued/in_progress/complete mapping.

other Flask stacks

Flask with a different engine

Flask +

Flask Celery Dashboard

The industry standard, covered end-to-end.
Flask +

Flask RQ Dashboard

Lightweight Redis queue, fully instrumented.
Flask +

Flask Dramatiq Dashboard

Middleware-driven Dramatiq observability.
Flask +

Flask Huey Dashboard

Lightweight Redis/SQLite queue, first-class.
Flask +

Flask taskiq Dashboard

Broker-agnostic async task framework.
arq on other frameworks

Same engine, different framework

+ arq

Django arq Dashboard

Django AppConfig integration, zero boilerplate.
+ arq

FastAPI arq Dashboard

Lifespan-hook integration for async stacks.

Start using Flask arq Dashboard

Self-hosted, open source, no SaaS, no telemetry. z4j runs anywhere Python or Docker runs.

Install z4j Read the docs