Skip to content

Default Profile

Dozzle persists per-user UI preferences (theme, locale, pinned containers, collapsed groups, visible JSON keys, etc.) to disk under /data/<username>/profile.json. When authentication is disabled, or for any user before they have signed in and customized their settings, Dozzle falls back to a special profile named __default__.

You can ship a pre-configured profile by creating the file /data/__default__/profile.json. Anonymous visitors and any new user without a saved profile will load these settings on first visit.

File Location

/data/__default__/profile.json

If the file does not exist, Dozzle starts with built-in defaults. You only need to create it if you want to override them.

Example

json
{
  "settings": {
    "showTimestamp": true,
    "showStd": false,
    "showAllContainers": false,
    "softWrap": true,
    "collapseNav": false,
    "smallerScrollbars": false,
    "search": false,
    "compact": false,
    "menuWidth": 250,
    "size": "medium",
    "lightTheme": "auto",
    "hourStyle": "auto",
    "dateLocale": "auto",
    "locale": "en",
    "groupContainers": "stack",
    "automaticRedirect": ""
  },
  "pinned": [],
  "visibleKeys": [],
  "collapsedGroups": []
}

All fields are optional — include only the ones you want to override.

Available Settings

FieldTypeDescription
showTimestampbooleanShow timestamps next to each log line
showStdbooleanShow stdout/stderr stream indicator
showAllContainersbooleanInclude stopped containers in the sidebar
softWrapbooleanWrap long log lines instead of horizontal scroll
collapseNavbooleanStart with the sidebar collapsed
smallerScrollbarsbooleanUse thinner scrollbars
searchbooleanEnable inline search by default
compactbooleanCompact log row spacing
menuWidthnumberSidebar width in pixels
sizestringFont size: small, medium, large
lightThemestringTheme preference: auto, light, dark
hourStylestringTime format: auto, 12, 24
dateLocalestringLocale used for date/time formatting (e.g. en-US, de-DE, auto)
localestringUI language (e.g. en, fr, de)
groupContainersstringDefault sidebar grouping (e.g. stack, none)
automaticRedirectstringPath to redirect to on load

The top-level fields pinned, visibleKeys, and collapsedGroups accept arrays and let you pre-pin containers or pre-collapse groups for first-time visitors.

How It Works

  • On page load, Dozzle reads /data/<username>/profile.json for the signed-in user, or /data/__default__/profile.json when no user is authenticated.
  • When a user changes a setting in the UI, the new value is persisted under their own username (or back into __default__ when auth is disabled).
  • The __default__ profile is therefore both the template for new visitors and the live profile for the anonymous user in unauthenticated deployments.

TIP

If you only want to seed defaults but still let the anonymous user customize them at runtime, mount the file read-only — Dozzle will fail to persist changes but the UI continues to work.

Released under the MIT License. Open sourced and sponsored by Docker OSS.