> ## Documentation Index > Fetch the complete documentation index at: https://docs.fly.io/llms.txt > Use this file to discover all available pages before exploring further. # Crontab with Supercronic Illustration by Annie Ruygt of Framkie the balloon wearing a sash and a prize ribbon in a gymnasium hall while a bird looks with admiration ## Overview `crontab` is a little too opinionated for containers—it's a great little tool, but when run inside of containers it doesn't grab `ENV` vars how we'd like it to. Fortunately there's a Go binary called `supercronic` that's a drop-in replacement for containers. The good news is that it's pretty easy to get it running on Fly with a little bit of copy and pasting. Let's get to it. ## Create a crontab file In the root of your project, add a `crontab` file. ``` touch ./crontab ``` If you need to run a job every 5 minutes, your `crontab` file would something like this: ``` */5 * * * * echo "hello world!" ``` Check out [cron.help](https://cron.help) if you need a quick crontab syntax reference. ## Install `supercronic` in the container The [latest releases for supercronic](https://github.com/aptible/supercronic/releases) are on [GitHub](https://github.com/aptible/supercronic), where they include copy pasta 🍝instructions for getting it in your Dockerfile. As of January 2024, the current version of `supercronic` is v0.2.29. You'll want to check the [releases page](https://github.com/aptible/supercronic/releases) for the latest version, but here's what it looks like now: ``` # Latest releases available at https://github.com/aptible/supercronic/releases ENV SUPERCRONIC_URL=https://github.com/aptible/supercronic/releases/download/v0.2.29/supercronic-linux-amd64 \ SUPERCRONIC=supercronic-linux-amd64 \ SUPERCRONIC_SHA1SUM=cd48d45c4b10f3f0bfdd3a57d054cd05ac96812b RUN curl -fsSLO "$SUPERCRONIC_URL" \ && echo "${SUPERCRONIC_SHA1SUM} ${SUPERCRONIC}" | sha1sum -c - \ && chmod +x "$SUPERCRONIC" \ && mv "$SUPERCRONIC" "/usr/local/bin/${SUPERCRONIC}" \ && ln -s "/usr/local/bin/${SUPERCRONIC}" /usr/local/bin/supercronic # You might need to change this depending on where your crontab is located COPY crontab crontab ``` After you put that in your Dockerfile, we're going to configure Fly to run only one instance of `supercronic`. Why? Because if you have a cronjob that does something like deliver emails to customers, you only want them to get that once. The last thing you want is them getting as many emails from your services that matches the number of instances you're running.

Setup a web & cron process

At the bottom of the `fly.toml` file, add the following: ``` [processes] # The command below is used to launch a Rails server; be sure to # replace with the command you're using to launch your server. web = "bin/rails fly:server" cron = "supercronic /app/crontab" ``` Then we have to tell Fly that your `web` process matches up with a service by having this under the `[[services]].` ``` # Make sure there's only one `processes` entry under `[[services]]` [[services]] processes = ["web"] ``` This change tells Fly that your `web` processes that you defined under `[processes]` will be exposed to the public internet. Your `cron` process won't be exposed to the public Internet because it doesn't need to!

Deploy & scale the new processes

Now that we've added `supercronic` to our `Dockerfile`, put the `crontab` at the root of our project folder, and reconfigured the `fly.toml` file, we're ready to deploy to production. ``` $ fly deploy ``` Then we'll need to scale the processes so that we only run one virtual machine container with the `cron` process. Be sure to change `web` to whatever number you had before. ``` $ fly scale count cron=1 web= ``` That's it! If all went well you now have cron running in a `cron` process in a Fly virtual machine. When you `fly deploy` it will get the latest code changes and reboot the virtual machines. ## Resources * [https://github.com/fly-apps/supercronic](https://github.com/fly-apps/supercronic) * [https://cron.help](https://cron.help) ## Related Reading * [Task scheduling guide with Cron Manager and friends](/blueprints/task-scheduling) A broader look at scheduling jobs on Fly.io — covers Cron Manager, Supercronic, scheduled Machines, and more. * [Run multiple process groups in an app](/launch/processes) Explains how to define processes in `fly.toml`, run multiple programs (web, cron, workers), scale by group. * [App Configuration (`fly.toml`)](/reference/configuration) In‑depth look at the config file that orchestrates your services, processes, health checks, etc.