Documentation

Settings

Use Settings to control the installation identity, email delivery, login behaviour and optional GeoIP lookup.
Open System > Settings from the admin menu. The page is split into System, SMTP, Authentication and GeoIP.
Save one section at a time. When a section depends on another one, configure the dependency first. For example, email-based login modes should only be enabled after SMTP has been saved and tested.

System

System Name

This is the name shown inside the installed dashboard. Use a short name that operators recognise, such as your company name, platform name or datacenter environment.
Do not place secrets, license keys or private hostnames here. This name is meant to identify the installation, not store configuration.

SMTP

SMTP controls email delivery. DCIM uses it for login codes, account emails and notification workflows. Keep SMTP disabled until the host, sender and credentials are correct.

Status

Use DISABLED while you are entering or testing settings. Switch to ENABLED only after a test email is delivered successfully.

Host

Enter the SMTP server hostname, for example smtp.example.com. Do not include a protocol such as https://.

Port

Use the port required by your mail provider. Port 587 is common for submission with STARTTLS. Port 465 is common for implicit TLS.

Use implicit TLS

Enable this when the SMTP provider expects TLS immediately when the connection opens, usually on port 465. Leave it disabled when the provider uses STARTTLS, commonly on port 587.

From Name

This is the sender display name users see in their mailbox. Use a clear value, such as DCIM or your platform name.

From Email

This is the sender email address. Use an address that belongs to a domain your SMTP provider is allowed to send from, such as [email protected].

Username

Enter the SMTP account username. Some providers use the full email address; others use a separate account name.

Password

Enter the SMTP password or app password for the SMTP account. If a password is already saved, leave this field empty to keep the current password.

Authentication

Authentication controls how admin and access users sign in. The default mode is password-only because it does not depend on email delivery.

PASSWORD_ONLY

Users sign in with email and password. Use this during first setup or when SMTP is not configured.

EMAIL_OTP_ONLY

Users sign in with a code sent by email. Use this only when SMTP is enabled and test emails are delivered reliably.

PASSWORD_AND_EMAIL_OTP

Users enter their password and then confirm an email code. This is the strictest built-in login mode and should only be enabled after SMTP is working.

GeoIP

GeoIP is optional. Enable it only if you have MaxMind credentials and want DCIM to use GeoIP databases for IP location data.

Status

Keep this set to DISABLED if you do not use MaxMind. Set it to ENABLED after the account ID and license key are available.

Account ID

Enter the MaxMind account ID for the account that owns the license key.

License Key

Enter the MaxMind license key. If a key is already saved, leave the field empty to keep the current key.