Custom settings

You can change the default settings by creating a settings.json file in runtipi/state/settings.json. This file makes your changes persist across restarts. Example file:


{
  "dnsIp": "9.9.9.9",
  "domain": "mydomain.com"
}

Be sure that the content is a valid JSON format. You can easily check for validity in an online tool like JSONLint

Available settings:

Parameter	Description	Type	Default value
`dnsIp`	The IP address of the DNS server to use. Legacy, kept for compatibility	`string`	`9.9.9.9`
`domain`	The domain name to use for the dashboard	`string`	`example.com`
`port`	The port to use for the dashboard	`integer`	`80`
`sslPort`	The port to use for the dashboard with SSL	`integer`	`443`
`listenIp`	The IP address to listen on	`string`	`automatically detected`
`appDataPath`	Base path to use for storing app data. Runtipi appends `/app-data` for you.	`string`	`runtipi`
`localDomain`	The domain name to use for local services	`string`	`tipi.lan`
`appsRepoUrl`	The URL to the apps repository	`string`	`https://github.com/runtipi/runtipi-appstore`
`postgresPort`	The port to use for the postgres database	`integer`	`5432`
`demoMode`	Start Runtipi in demo mode	`boolean`	`false`
`guestDashboard`	Allow guest access to the dashboard	`boolean`	`false`
`allowErrorMonitoring`	Whether the app will send anonymous crash reports to the Runtipi developers	`boolean`	`false`
`allowAutoThemes`	Enables thematically changing the dashboard based on the time of the year	`boolean`	`true`
`persistTraefikConfig`	Do not replace the Traefik config on every restart of Runtipi	`boolean`	`false`
`eventsTimeout`	The time in minutes to wait for an action to complete before timing out	`integer`	`5`
`advancedSettings`	Show advanced settings in the dashboard	`boolean`	`false`
`forwardAuthUrl`	Override the Traefik forward-auth endpoint	`string`	`http://runtipi:3000/api/auth/traefik`
`logLevel`	Backend log level	`string`	`info`
`maxBackups`	Maximum number of backups to keep per app	`integer`	`0`
`timeZone`	Timezone used by Runtipi and many apps	`string`	system timezone
`themeBase`	Dashboard base theme	`string`	`gray`
`themeColor`	Dashboard accent color	`string`	`blue`
`experimental_insecureCookie`	Disable secure cookie handling for debugging only	`boolean`	`false`