The deckrun.toml file

The deckrun.toml file is the heart of your application's configuration in Deckrun. It's a simple, human-readable file that tells Deckrun everything it needs to know about how to build, deploy, and manage your application in the cloud.

Think of it as your app's blueprint. In this file, you define the different components of your application - such as web servers, background workers, and scheduled cron jobs - and specify their requirements.

TOML Format

The deckrun.toml file uses the TOML format, which stands for "Tom's Obvious, Minimal Language." It's designed to be easy to read due to its clear semantics. You can learn more about the format on the official TOML website.

If you want to check the validity of your deckrun.toml file, you can use an online tool like TOML Lint, which is a TOML validator.

What can you configure?

Inside the deckrun.toml file, you can configure a wide range of settings for your application, including:

• Processes and Cron Jobs: Define the commands to run your web servers, workers, and scheduled tasks.
• Resource Allocation: Set CPU and memory limits for each component of your app.
• Environment Variables: Manage your application's environment variables and secrets.
• Health Checks: Configure liveness and readiness probes to ensure your application is healthy.
• Autoscaling: Define rules to automatically scale your application based on traffic and resource usage.

Once you've defined your application's configuration in deckrun.toml, Deckrun takes care of the rest. It handles the complexities of building, deploying, and managing your application, making cloud deployments effortless.