Leek gives you a live view of your Celery task queue. Celery is a system that runs background jobs for other apps. Leek connects to your broker and shows what is happening in real time.
Use it to:
- see tasks as they run
- check which workers are online
- inspect task data and results
- review errors and retries
- stop or cancel tasks when needed
Leek runs in a single Docker container. You do not need to change your app code. You do not need to install agents or plugins.
Leek runs on Windows through Docker Desktop.
You will need:
- a Windows 10 or Windows 11 PC
- Docker Desktop installed
- access to your Celery broker, such as Redis or RabbitMQ
- a web browser
If you already use Celery, Leek can read the same broker your workers use.
Visit the releases page to download Leek
On the releases page:
- open the latest release
- download the file for Windows or the Docker image package
- save the file to a folder you can find again
If the release gives you a Docker image only, you can still run it on Windows with Docker Desktop
If Docker Desktop is not on your PC:
- download Docker Desktop from the Docker website
- install it using the setup file
- restart your computer if Windows asks you to
- open Docker Desktop and wait until it says it is ready
Keep Docker running while you use Leek
If you downloaded a release package, follow the file instructions in the release page
If you plan to run Leek with Docker, use the image from the release page and start it with your broker details
Common things you will need to set:
- broker address
- broker username and password, if used
- port for the web dashboard
- any task queue names you want to watch
Start the container, then wait for it to finish loading. Open your browser and go to the local address shown in the release instructions or container output
After Leek starts, open your browser and visit the dashboard address.
You should see:
- a live task count
- a chart of task activity
- worker status
- recent task activity
- live event updates
If the page does not load, check that:
- Docker is running
- the container is still active
- the broker address is correct
- your Celery workers are online
See live task counts, throughput, worker status, and recent activity in one place.
Search, filter, and sort tasks in a table that updates live.
Open a task to see:
- args and kwargs
- result
- error text
- traceback
- state history
- retry chain
- revoke and terminate controls
Review task types by count, failure rate, and run time. Switch between card and list views and see the five most recent tasks for each type.
Track worker online status, heartbeats, active task counts, and worker data.
Watch Celery events as they happen and filter the feed to find the activity you need.
If you are setting Leek up for the first time, use this order:
- install Docker Desktop
- open the releases page
- download the latest Leek release
- start Docker Desktop
- run Leek with your broker details
- open the dashboard in your browser
If you use Redis, your broker address may look like this:
- redis://localhost:6379/0
If you use RabbitMQ, your broker address may look like this:
- amqp://guest:guest@localhost:5672//
Use the address that matches your own setup
Leek reads task and worker data from your Celery broker.
You may need:
- broker host name
- port number
- username
- password
- virtual host or database number
If your broker runs on another computer, make sure your PC can reach it on the network
You know Leek is working when:
- the dashboard opens in your browser
- task counts start to change
- worker status appears
- recent events show up
- you can open a task and see its details
If the screen stays empty, wait a few seconds and refresh the page
A release may include:
- a Windows download package
- a Docker image reference
- a sample config file
- a short release note
Use the release note first if it includes a Windows-specific run step
Leek fits well when you want to:
- watch Celery tasks without opening logs
- see which workers are busy
- check failed tasks fast
- inspect task arguments and results
- stop a task that is stuck
- review task history during testing or support work
Leek works in a modern browser such as:
- Microsoft Edge
- Google Chrome
- Firefox
For the best view, keep the browser window wide so tables and charts have room
Leek uses live updates to show new task activity. If the broker is busy, data may take a moment to appear.
If the page stops updating:
- refresh the browser page
- check Docker Desktop
- make sure your Celery workers are still running
- confirm the broker settings match your Celery app
When you are done:
- close the browser tab
- stop the running Docker container
- leave Docker Desktop open only if you still need it for other apps
Before you begin, make sure you have:
- a working Celery app
- access to the broker used by that app
- Docker Desktop on Windows
- a web browser
- enough rights on your PC to run Docker
If you need a newer build later, return to the same page and get the latest release