Skip to content

Settings

Settings

The Settings page lets administrators configure system-wide login behavior. You can manage settings through both the GUI and the CLI.

GUI

Open Settings from the left sidebar by clicking the Settings (gear) icon.

Settings in sidebar Settings in sidebar

Login settings

The Login section controls how users authenticate and how long sessions last.

Login settings Login settings

Walkthrough

  1. Open Settings
    In the Datatailr GUI, click the Settings icon in the left sidebar. The Settings page opens with the Login card.

  2. JWT expiration time
    Set how long a signed-in session stays valid. Use a duration string, for example:

  3. 10s — 10 seconds
  4. 5m — 5 minutes
  5. 2h — 2 hours
  6. 3d — 3 days

Enter the value in the JWT expiration time field. Shorter values improve security but require more frequent logins.

  1. Enable MFA
    Turn Enable MFA on to require multi-factor authentication for user logins. When enabled, users must complete a second factor (e.g. TOTP) in addition to their password.

  2. Save or discard

  3. Click Save to apply changes.
  4. If you edited fields but don't want to keep them, click Discard to reset the form to the last saved state.

Changes take effect for new logins and token refreshes; existing sessions may continue until their tokens expire.

CLI

Settings can also be managed with the dt settings commands. This is useful for scripting and automation.

Action Command
List all settings dt settings ls
List settings by prefix dt settings ls <prefix>
Get a setting dt settings get <key>
Set a setting dt settings put <key> <value>
Remove a setting dt settings rm <key>

Examples:

# List all settings
dt settings ls

# Get a specific setting
dt settings get <key>

# Set a value
dt settings put <key> <value>

# Set a value from a file
dt settings put <key> file:///path/to/file.json

Add -p to pretty-print output or -j for JSON output.