Priority

By default, restic is running with the default priority. It means it will get equal share of the resources with other processes.

You can lower the priority of restic to avoid slowing down other processes. This is especially useful when you run restic on a production server.

Nice

You can use these values for the priority parameter, string or numeric values are both valid:

IO Nice

This setting is only available on Linux. It allows you to set the disks IO priority of restic.

More information about ionice “class” and “level” can be found here.

Examples

version = "1"

[global]
  # priority is using priority class on windows, and "nice" on unixes
  priority = "low"
  # ionice is available on Linux only
  ionice = true
  ionice-class = 2
  ionice-level = 6

version: "1"

global:
  # priority is using priority class on windows, and "nice" on unixes
  priority: low
  # ionice is available on Linux only
  ionice: true
  ionice-class: 2
  ionice-level: 6

global {
    # priority is using priority class on windows, and "nice" on unixes
    priority = "low"
    # ionice is available on Linux only
    ionice = true
    ionice-class = 2
    ionice-level = 6
}

Warnings

In some cases (mostly before version v0.27.0), resticprofile won’t be able to set the priority of restic.

A warning message like this will be displayed:

cannot set process group priority, restic will run with the default priority: operation not permitted

This either means:

• resticprofile is running inside docker
• you are using a tight security linux distribution which is launching every process inside a new container
• resticprofile is running in WSL
• you’re running an older version of resticprofile (< v0.27.0)