Deploy to Fly.io

This article covers how to deploy a Monika instance to Fly.io.

1. Go to the Monika Github repository and download two files: Dockerfile.flyio and fly.toml.example

2. Rename the fly.toml.example to fly.toml`.

3. Edit the contents of the fly.toml:

   1 app = "monika" # Change the app name to the desired name
   2 
   3 kill_signal = "SIGINT"
   4 kill_timeout = 5
   5 
   6 [build]
   7 dockerfile = "Dockerfile.flyio"
   8 
   9 [build.args]
   10 PARAMS = "-v" # Change the parameters according to your needs
   11 
   12 [env]
   13 PARAMS = "-v" # Match the content of this PARAMS variable to the one in `build.args` block
   14 
   15 [experimental]
   16 auto_rollback = true
   

   Refer to the Fly.io App Configuration Docs to customize the example TOML even further.

4. Install Fly.io CLI tools (flyctl) in your computer

5. a. Proceed to authenticate to Fly.io by running flyctl auth login in your terminal.

   b. If you haven't signed up to Fly.io yet, you can sign up by running flyctl auth signup in your terminal.

6. Create a new Fly.io app by running flyctl apps create and enter the app name according to your fly.toml you have created before.

7. Deploy Monika to your Fly.io by running flyctl deploy

8. Wait until the deployment is finished, and check Monika logs from the Fly.io dashboard to confirm that your Monika instance is running.