Open Settings with the button in the sidebar or from the command palette (Open settings). It has five tabs: Servers, Appearance, Data, Security, Shortcuts. Some actions apply immediately (see below); the other tab fields apply with the Save Changes button.
Servers
Each server row shows the color, name, the protocol badge (HTTP/TCP), host:port, and live status (running · N conn or stopped, refreshed roughly every 2 s).
Per-server actions:
- Enable/Disable toggle – turns the server on/off (applies and syncs immediately).
- Send test dump – sends a sample
logdump (only when the server is running). - Edit / Delete.
- Add Server – creates a server with the defaults
New Server,localhost,21234, colorblue, active, protocolhttp.
Fields when adding/editing:
- Name (required).
- Availability –
This computer(listens only on127.0.0.1) orNetwork(listens on0.0.0.0, exposed to the LAN). ChoosingNetworkopens a confirmation that requires a shared token, see Security. - Port – 1–65535.
- Protocol –
HTTP (recommended)orTCP (legacy). The hint shows the resulting address (POST http://host:port/dumpsor a raw TCP socket). - Color –
blue,red,green,yellow,purple,pink,gray.
Validation: a network-exposed server requires a non-empty token; a duplicate host:port (across servers) is rejected.
Appearance
| Setting | Options | Effect |
|---|---|---|
| Color scheme | light / dark / system | The app theme (system follows the OS) |
| Accent color | blue, violet, emerald, rose, amber, cyan | Recolors buttons, links, and active states |
| View mode | detailed / compact | How much detail each dump shows |
| List density | comfortable / compact | Row height in the list |
| Font size | small / medium / large | Base font size (14/16/18 px) |
| Editor | Off, VS Code, VS Code Insiders, Cursor, PhpStorm, WebStorm, IntelliJ IDEA, Sublime Text, TextMate, Zed | Enables clicking file:line locations. Saved per machine, applies immediately. |
Data
| Setting | Default | Meaning |
|---|---|---|
| Automatically save dumps to disk | off | Auto-save to dumps.json every 5 seconds |
| Force save dumps when application exits | off | Save all dumps before closing |
| Auto-start servers on launch | on | Start active servers when the app opens |
| Maximum dumps in memory | 1000 (100–10000) | Older dumps are discarded when the limit is reached |
Storage & backups: Open data folder, Export settings, Import settings.
Danger zone:
- Reset to defaults – restores the default appearance and data values (servers are kept); applies on save.
- Clear all dumps – immediate and irreversible.
For storage details, see the Storage page.
Security
| Setting | Default | Meaning |
|---|---|---|
| Access token (optional) | empty (off) | When set, every dump must carry it. The Generate button creates a Dio- + 48 hex-character token. |
| Max payload size (KB) | 1024 | Requests/messages above the limit are rejected (413 for HTTP; connection closed for TCP). |
| Rate limit (messages/second) | 1000 | Per client/connection; 0 disables it. |
Token transport: HTTP uses Authorization: Bearer <token> or X-Dumpio-Token; TCP carries a token field inside the JSON. Details on the Security page.
Shortcuts
Read-only — an overview of the keyboard shortcuts. Shortcuts are fixed and not customizable. See the Viewer page.
Where settings are stored
All settings live in a settings.json file in the app's user-data folder (open it via Open data folder). New fields are merged with the defaults on read, so an upgrade preserves your configuration. A few display preferences (the chosen editor, filters, pinning) are stored in the browser's local storage rather than in settings.json.