Skip to content


Plans in Mottainai are special tasks with an extra field, planned, which is indicating the recurrence of a task.

This means they heredit the full syntax from the tasks, the only difference stands for the extra field ( "planned" ).

Plans can be submitted to the infrastructure with the CLI, or with Replicant.


Full task example

# Task name
name: "My task"

# Image used by the task player
image: "my/image"

# Script to be executed
  - echo "hello world"

# Task type
type: docker

# We want the task to be executed weekly
planned: "@weekly"

planned fully supports the cron syntax, here you can find a short summary.

Note: Mottainai it's using internally robfig/cron , this is an extract from their documentation for reference. Head over here for a full explanation of the supported syntax .

Predefined schedules

Entry Description Equivalent To
@yearly (or @annually) Run once a year, midnight, Jan. 1st 0 0 0 1 1 *
@monthly Run once a month, midnight, first of month 0 0 0 1 * *
@weekly Run once a week, midnight between Sat/Sun 0 0 0 * * 0
@daily (or @midnight) Run once a day, midnight 0 0 0 * * *
@hourly Run once an hour, beginning of hour 0 0 * *


You may also schedule a job to execute at fixed intervals, starting at the time it's added. This is supported by using the planned field like this:

@every <duration>

where "duration" is a string accepted by time.ParseDuration (

For example, "@every 1h30m10s" would indicate a schedule that activates after 1 hour, 30 minutes, 10 seconds, and then every interval after that.

Note: The interval does not take the job runtime into account. For example, if a job takes 3 minutes to run, and it is scheduled to run every 5 minutes, it will have only 2 minutes of idle time between each run.


To deploy all plans defined in a Git repository, you can use Replicant.

In order to keep trace of the plans in the infrastructure, Replicant parses all plans in a Git repository, and automatically submits and keep the infrastructure in sync with the content.

You can even combine and run a Replicant task which is a webhook inside Mottainai, that automatically keeps your infrastructure updated.