Workloads

Jobs

A job is a command Portiger runs for you - a nightly backup, a cache flush, a migration. A scheduled job is not a separate kind of thing: it is a job with a schedule. Nothing runs on the host itself; a job runs in a container.

The Jobs page listing three jobs with their schedules, where each runs, its command, and the result of its last run, with Run now, Disable, Edit and Delete buttons.
Three jobs, two schedules and one that is disabled: what runs, where, and how it went last time.

Where it runs

An image has to be on this installation already; the form says so and links to the Images page rather than pulling something silently.

When it runs

Only when I run it
Nothing fires on its own. The list's Run now is the whole trigger.
On a schedule
Five cron fields - minute, hour, day of month, month, day of week - with presets for every minute, every five minutes, hourly, daily, weekly and monthly.
Once, at a set time
A date and time in your own timezone. The job disables itself once it has fired.

The rest of the form

If one is still running
Start it anyway, skip the new one, or stop the old one and start fresh. Skipping is the default.
Timeout
Seconds before the run is given up on. Required.
Retries
How many further attempts a failed run gets. None by default.
Tell me
Never, when it fails, or every time. The result goes to your notification channels - see Monitoring and notifications.
Command
Run through a shell, so pipes and && work.

The run history

A job's own page keeps its runs: when each started, whether it succeeded, its exit code, how long it took, whether its schedule or a person started it and which attempt it was. Each row can be expanded to show the tail of its output. Pressing Run now opens the new run's output as soon as it exists.

How many you get

PlanJobs
CommunityNot included
Personal10
TeamUnlimited
MaxUnlimited

On Community the page says jobs are not part of the plan rather than showing an empty list. On Personal the header counts what is used against the ten, and the create button turns itself off at the limit.

Portiger's own maintenance is not a job. Backups, certificate renewal, DKIM, cleanup and metrics run inside the process on their own schedule. They are not in this list and cannot be edited here.
dev