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": 15,
    "size": "medium",
    "lightTheme": "auto",
    "hourStyle": "auto",
    "dateLocale": "auto",
    "locale": "en",
    "groupContainers": "at-least-2",
    "automaticRedirect": "delayed"
  },
  "pinned": [],
  "visibleKeys": [],
  "collapsedGroups": []
}

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

Available Settings

Field	Type	Description
`showTimestamp`	boolean	Show timestamps next to each log line
`showStd`	boolean	Show stdout/stderr stream indicator
`showAllContainers`	boolean	Include stopped containers in the sidebar
`softWrap`	boolean	Wrap long log lines instead of horizontal scroll
`collapseNav`	boolean	Start with the sidebar collapsed
`smallerScrollbars`	boolean	Use thinner scrollbars
`search`	boolean	Enable inline search by default
`compact`	boolean	Compact log row spacing
`menuWidth`	number	Sidebar width as a percentage of the window. Capped at `50`.
`size`	string	Font size: `small`, `medium`, `large`
`lightTheme`	string	Theme preference: `auto`, `light`, `dark`
`hourStyle`	string	Time format: `auto`, `12`, `24`
`dateLocale`	string	Date/time formatting: `auto`, `en-US`, `en-GB`, `de-DE`, `en-CA`
`locale`	string	UI language (e.g. `en`, `fr`, `de`)
`groupContainers`	string	Sidebar grouping: `always`, `at-least-2`, `never`
`automaticRedirect`	string	Redirect to a new container: `instant`, `delayed`, `none`

Values outside these sets are not accepted, so groupContainers: "stack" or a dateLocale of fr-FR will not do what you expect.

The top-level fields pinned, visibleKeys, and collapsedGroups accept arrays and let you pre-pin containers or pre-collapse groups for first-time visitors. Dozzle also writes releaseSeen, dismissedImageUpdates, and dismissedLinkHint at the top level to remember what a user has already dismissed. Seeding dismissedLinkHint: true suppresses the first-run link hint for everyone.

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. :::