# Wger-celery-beat

Wger-celery-beat is a self-hosted automation app. Celery Beat is the scheduled-task runner for wger, a free self-hosted workout and fitness manager, automatically running periodic background jobs such as exercise-data sync and database cleanup. It is open source and self-hosted, installable on Docker Hub, Umbrel and Unraid.

Canonical page: https://ourlocalhost.com/app/729/wger-celery-beat

## Description

Celery Beat is the scheduled-task runner for wger, a free self-hosted workout and fitness manager, automatically running periodic background jobs such as exercise-data sync and database cleanup.

## Platform availability

Available on 2 of 9 platforms: Unraid, Umbrel.

## Links

- Docker Hub: https://hub.docker.com/r/wger/server
- Umbrel: https://apps.umbrel.com/app/wger
- Unraid: https://ca.unraid.net/apps/wger-celery-beat-1gq6z0a1slo1ae?q=wger-celery-beat
- Official website: https://wger.de
- GitHub: https://github.com/wger-project/wger

## Common questions

### What command starts the wger periodic-task scheduler, and what happens if it is not running?

Run celery -A wger beat -l INFO in the same wger setup to start Celery Beat. Without it, scheduled tasks will not happen even if the web app is running.

### How should the scheduler be kept running in a production deployment?

It should be properly daemonized as a service. One documented option is a systemd service file.

### Which environment and database settings must be correct before starting the scheduler?

Set ALLOWED_HOSTS, a long random DJANGO_SECRET_KEY, and database login details in wger.env. Also create a PostgreSQL database and user named wger with a password. If these are missing or wrong, wger and the background scheduler may fail to start or reach the database.

### What does the community say about running it with Portainer?

One self-hoster was trying to put the wger app on Portainer and reported having issues, but the source does not provide a working guide.

## Alternatives

- GymMane: GymMane is a free, offline gym log for Android.
- Hevy Workout Tracker: Simple workout logging, insightful analytics, and a growing community of gym athletes.
- Liftosaur: The most flexible weightlifting tracker app ever.
- Strong: Strength training logger.
- openGym: openGym is a self-hosted gym and body-weight tracker.

---
Source: Our Local Host (https://ourlocalhost.com/app/729/wger-celery-beat), the self-hosted and open-source app directory.