# Crontab

Crontab is a self-hosted automation app. A lightweight Docker container that lets you schedule cron jobs and run them inside other containers through the Docker CLI. It is open source and self-hosted, installable on Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/739/crontab

## Description

A lightweight Docker container that lets you schedule cron jobs and run them inside other containers through the Docker CLI.

## Platform availability

Available on 1 of 9 platforms: Unraid.

## Health score

19/100 (Low), based on 3 of 4 factors.
- Maintained: 0 (last commit 2126 days ago)
- Popular: 50 (318 GitHub stars)
- Easy to install: 20 (1 install platform, Docker image)

## Links

- Docker Hub: https://hub.docker.com/r/willfarrell/crontab
- Unraid: https://ca.unraid.net/apps/crontab-0jgwuwf04ob0vf?q=Crontab

## Common questions

### Can the crontab config be written in JSON, TOML, or YAML?

Yes, the config file can be specified in JSON, TOML, or YAML. It may be an array or a mapping, with top-level keys ignored in mapping mode.

### How do I run a job in an existing container instead of starting an image?

Set the container field to the full container name or the container alias if project is set. If image is also included, container is ignored because the job starts the specified image.

### Can a job trigger commands in other containers after it completes?

Yes, use the trigger field with an array of docker-crontab subset objects. Each trigger can specify image, project, container, command, or dockerargs.

### How do I add environment files or volumes to a Docker job?

Use dockerargs to pass Docker run or exec command line arguments for full control. The README shows using dockerargs for env-file and volume mounts.

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