# Ofelia

Ofelia is a low-footprint, Go-based Docker job scheduler that runs cron-style tasks in the Ofelia container or other Docker containers via labels, helping homelab admins automate recurring jobs. It is open source and self-hosted, installable on Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/406/ofelia

## Description

Ofelia is a low-footprint, Go-based Docker job scheduler that runs cron-style tasks in the Ofelia container or other Docker containers via labels, helping homelab admins automate recurring jobs.

## Platform availability

Available on 1 of 9 platforms: Unraid.

## Health score

66/100 (Good), based on 4 of 5 factors.
- Maintained: 75 (last commit 68 days ago)
- Popular: 72 (4,005 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Security check: 72 (no serious findings, 1 minor, CI, tests, OpenSSF Scorecard 3.9/10)

## Links

- Docker Hub: https://hub.docker.com/r/mcuadros/ofelia
- GitHub: https://github.com/mcuadros/ofelia
- Unraid: https://ca.unraid.net/apps/ofelia-1wxr5g40rljy3k?q=Ofelia

## Common questions

### How do I enable Ofelia to manage jobs defined in Docker containers?

Start the Ofelia daemon with --docker when your jobs run in Docker containers, and add --config if your settings file is not in the default place. Without Docker mode, Ofelia may not be able to see or run your container-based scheduled jobs.

### How can I get email alerts when a scheduled job fails?

In the mail settings, enter your SMTP host, username, app password, and the email addresses that should receive alerts. If you skip this, your jobs can still run, but you will not get an email telling you when one fails.

### Can Ofelia run a scheduled command outside an existing labeled container?

Ofelia can execute commands directly on Docker containers, run commands in new containers, and execute commands on the host running Ofelia.

### Why might traditional cron be unsuitable for scheduled jobs in Docker?

Traditional cron can fail in containers, and reliable scheduled tasks can be implemented using Supercronic, Ofelia, or host cron with docker exec.

---
Source: Our Local Host (https://ourlocalhost.com/app/406/ofelia), the self-hosted and open-source app directory.