Wger-celery-beat

Celery Beat is the scheduled-task runner for wger, a free self-hosted workout and fitness manager, automatically running periodic background jobs such as…

  • Automation
  • Productivity
  • Tools & Utilities
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 10 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

80/100 Excellent

Maintained
100last commit 17 days ago
Popular
777,231 GitHub stars
Easy to install
452 install platforms, install notes, Docker image
Light to run
No data

Based on 3 of 4 factors.

Availability: platform listings confirmed today, links checked 53 days ago

GitHub stars
7,231
Open issues
246
Last commit
2026-11-03
Latest release
2.7
License
AGPL-3.0
Activity
declining

Checked 17 days ago - source: GitHub (wger-project/wger)

Resources & Compatibility

ARM (e.g. Raspberry Pi) is supported.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Fill in wger.env before starting In your wger.env settings file, set ALLOWED_HOSTS to your site address, add a long random DJANGO_SECRET_KEY (a secret string the app uses to secure sessions), and enter the database login details. If these are missing or wrong, wger and the background scheduler may fail to start or may be unable to reach the database. source
  • Create the database first Install PostgreSQL (the database program that stores users, workouts, and settings) and create a database and user named wger with a password. If the database is missing or the credentials do not match, wger has nowhere to save data and will fail to start. source
  • Start the Celery Beat timer Run celery -A wger beat -l INFO in the same wger setup to start Celery Beat, which is the scheduler that runs background jobs at set times. Without it, scheduled tasks will not happen even if the web app is running. source

Fetched 54 days ago - each note links to its source

Alternatives (5)

  • GymMane - GymMane is a free, open-source gym log for Android that lets you tap muscles on an interactive body map to build workouts, track sets with…
  • 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 that plans workouts, logs sets, supports passkey sign-in, and provides a web container…

Checked 40 days ago - source: AlternativeTo

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.

Answers sourced from wger.readthedocs.io, wger.readthedocs.io, wger.readthedocs.io, www.reddit.com

Community

Collected 48 days ago - public community threads