Instance settings

Instance settings control the Coolify control plane itself. These settings change the Coolify instance itself, not a project, application, database, service, or server.

Coolify Cloud

If you use Coolify Cloud, the Coolify team manages the Coolify instance for you. Coolify Cloud users cannot access or edit these settings.

Example Data

The following data is used as an example in this guide. Please replace it with your actual data when following the steps:

Domain Name: shadowarcanist.com
Coolify Dashboard: https://coolify.shadowarcanist.com

Open the page from Settings in the left sidebar, or visit:

https://coolify.shadowarcanist.com/settings

You can configure your Coolify instance from the Settings page. The Settings area is split into Configuration, Backup, Transactional Email, OAuth, and Scheduled Jobs pages. Each page and its options are explained below.

Configuration

Use General for the basics of the Coolify instance: the dashboard URL people open, the instance label, the timezone for instance-level schedules, and the public IPs Coolify should use when auto-detection is wrong.

URL

This is the address you use to open the Coolify dashboard. Coolify also uses it when it needs to generate links back to the instance. If you want the dashboard to use HTTPS, the value must start with https://.

Enter the full dashboard URL in URL and click Save. Before changing it, make sure DNS for the domain points to the server where Coolify is running. If DNS validation is enabled, Coolify checks the domain. Coolify also warns you when the instance URL is already used by another resource.

Accepted values:

A full URL with a protocol, for example https://coolify.shadowarcanist.com.
Use https:// when the dashboard should be served over HTTPS.
A root domain or subdomain.

Notes:

Path-based URLs such as https://shadowarcanist.com/coolify are not supported.
Do not reuse an application or service domain for the dashboard. If the instance URL conflicts with a resource domain, SSL certificates and routing can become unpredictable.

Name

This is the human-readable label for the Coolify instance. It is useful when you manage more than one Coolify install and need to quickly recognize which dashboard you are using.

Update Name and click Save.

Accepted values:

Any text value up to 255 characters.
Leave it empty to keep the default Coolify instance name.

Instance Timezone

This timezone is used by instance-level schedules, including update checks and automatic updates. It does not change the timezone inside your applications or databases.

Search for the timezone in Instance Timezone, select it from the list, and save.

Accepted values:

A valid timezone identifier from the dashboard list, for example UTC, Europe/Berlin, or Asia/Colombo.

Notes:

Database backup schedules can use the server timezone when the server has one configured. Otherwise, they fall back to the instance timezone.

Instance's Public IPv4

Coolify normally detects the public IPv4 address of the server that runs the instance. Use this field only when the detected address is wrong, usually on servers with multiple public IPs.

Enter the IPv4 address Coolify should use and click Save.

Accepted values:

Leave it empty to let Coolify use the detected address.
A valid IPv4 address, for example 203.0.113.10.

Instance's Public IPv6

Coolify normally detects the public IPv6 address of the server that runs the instance. Use this field only when Coolify picks the wrong IPv6 address or cannot detect it.

Enter the IPv6 address Coolify should use and click Save.

Accepted values:

Leave it empty to let Coolify use the detected address.
A valid IPv6 address, for example 2001:db8::1.

Backup

The Backup page is for the internal Coolify database. It does not back up every application volume or every external database.

Configure Backup

Creates the Coolify database resource and scheduled backup configuration needed for instance backups.

If Coolify shows Configure Backup, click it first. If the localhost server is not validated, validate the server before configuring backups.

Accepted values:

Available only when the localhost server is functional.
Creates or reveals the internal coolify-db backup configuration.

For the detailed guide, follow Instance backup.

Description

Stores a short note for the internal Coolify database resource shown on the Backup page.

Update Description, then click Save.

Accepted values:

Any text value, or empty if you do not need a description.

UUID, Name, User, Password

Shows the internal database identity and credentials Coolify uses for its own database backup resource.

These fields are read-only on the Backup page. Change backup behavior from the Scheduled Backup section instead.

Accepted values:

Read-only values generated and managed by Coolify.

Transactional Email

Sender settings are shared by SMTP and Resend.

From Name

Sets the display name used in Coolify emails such as password resets and invitations.

Enter From Name, then save.

Accepted values:

A required text value, for example Coolify.

From Address

Sets the email address used as the sender for Coolify emails.

Enter From Address, then save.

Accepted values:

A required valid email address, for example [email protected].

Send Test Email

Sends a test message using the currently enabled transactional email provider.

After SMTP or Resend is enabled and saved, click Send Test Email, enter a recipient, and send it.

Accepted values:

A valid recipient email address.

OAuth

Each provider card has its own enabled state, credentials, and redirect URI.

Provider

Selects which external identity provider users can use to sign in to Coolify.

Configure the provider card for the provider you want to enable.

Accepted values:

azure, bitbucket, clerk, discord, github, gitlab, google, authentik, infomaniak, or zitadel.

For the detailed guide, follow OAuth setup.

Enabled

Controls whether a specific OAuth provider can be used on the Coolify sign-in page.

Fill the required provider fields, then toggle Enabled for that provider.

Accepted values:

Enabled: the provider can be used if required fields are complete.
Disabled: the provider is hidden or unavailable for sign-in.

Client ID

Stores the OAuth application client ID from the identity provider.

Create an OAuth application with the provider, copy its client ID, paste it into Client ID, then save.

Accepted values:

Any provider-issued client ID string required by the provider.

Client Secret

Stores the OAuth application secret from the identity provider.

Copy the provider client secret, paste it into Client Secret, then save.

Accepted values:

Any provider-issued client secret string required by the provider.

Redirect URI

Defines the callback URL the identity provider redirects back to after authorization.

Copy the Redirect URI shown by Coolify into the OAuth application at the provider, then save the same value in Coolify if you override it.

Accepted values:

A full URL matching the provider callback, usually https://coolify.shadowarcanist.com/auth/<provider>/callback.

Scheduled Jobs

Failures shows scheduled backup, task, and cleanup executions that did not finish successfully.

Type Filter

Filters the failures list by the kind of scheduled work that failed.

Select a value from Type and review the filtered list.

Accepted values:

all, backup, task, or cleanup.

Time Range Filter

Filters failures by when they happened.

Select a value from Time Range and review the filtered list.

Accepted values:

last_24h, last_7d, last_30d, or all.

Failure Table

Shows the failed job type, resource, server, start time, duration, and error message.

Use Refresh to reload the page data after you fix a failed backup, task, or cleanup job.

Accepted values:

Read-only execution rows generated from failed scheduled work.

On this page