Skip to main content

Configuration Options

The following configuration options are available and can be passed as environment variables.

If you don't know how to set them, look up the section for your type of installment in the installation section.

UI Features

DASHDOT_SHOW_HOST

If you want to show the host part in the server widget (e.g. dash. -> dash.mauz.io).

  • type: boolean
  • default: false
falsetrue
Server widget normalServer widget with host

DASHDOT_ENABLE_CPU_TEMPS

If you want to show the CPU temperature in the graph. This will probably not work on a VPS, so you need to try it on your own if this works. For home servers it might work just fine.

  • type: boolean
  • default: false
falsetrue
CPU widget normalCPU widget with temps

DASHDOT_ENABLE_STORAGE_SPLIT_VIEW

If you want to enable an optional split view for the storage widget, set this to true.

The split view will only work reliably, if all drives are mounted in the container. Otherwise, any unassigned space will be attributed to the host drive.

  • type: boolean
  • default: false
falsetrue
Storage widget single viewStorage widget multi view

DASHDOT_USE_IMPERIAL

Shows any units in the imperial system, instead of the default metric.

  • type: boolean
  • default: false
falsetrue
CPU widget with temps in celsiusCPU widget with temps in fahrenheit

DASHDOT_ALWAYS_SHOW_PERCENTAGES

To always show the current percentage of each graph in the top-left corner. Without enabling this, they will only be shown on lower resolution devices (mobile phones).

  • type: boolean
  • default: false
falsetrue
Dashboard iwith no percentagesDashboard with percentages

DASHDOT_PAGE_TITLE

If you want to show a custom string in the browser page title.

  • type: string
  • default: dash.

General

DASHDOT_PORT

The port where the express backend is running (the backend serves the frontend, so it is the same port for both).

  • type: number
  • default: 3001

DASHDOT_ACCEPT_OOKLA_EULA

Use the newer and more accurate speedtest tool from Ookla, instead of the old speedtest-cli for your speedtests. When passing this flag, you accept Ooklas: EULA, TERMS and PRIVACY.

  • type: boolean
  • default: false

DASHDOT_USE_NETWORK_INTERFACE

If dash. detects the wrong gateway as your default interface, you can provide a name here that is used instead.

  • type: string
  • default: unset

DASHDOT_FS_DEVICE_FILTER

To hide specific drives, you can pass the device names as a string list using this parameter. If you don't know the device names of your drives, have a look at the log of dash. and look for the Static Server Info -> storage output.

storage: {
layout: [
{
device: 'nvme0n1',
brand: 'Samsung',
size: 500107862016,
type: 'NVMe',
raidGroup: '',
},
{
device: 'sda',
brand: 'DELL',
size: 4000225165312,
type: 'HD',
raidGroup: '',
},
];
}
  • type: string (comma separated list)
  • default: unset

DASHDOT_FS_TYPE_FILTER

If dash. detects network drives as internal drives, you can provide a list of ignored FS types here. Please also create a bug ticket on the repository though, so that we can fix this problem for everyone.

  • type: string (comma separated list)
  • default: cifs,9p,fuse.rclone,fuse.mergerfs,nfs4

DASHDOT_FS_VIRTUAL_MOUNTS

If you want to show a virtual mount in the storage split view, that is ignored in the filter above. Can be used for example to show fuse.mergerfs mounts, which is basically a grouping of other mounts.

You need to pass the names of the filesystems you want to use. To find out what the name is, execute df and look at the first column.

Note that this will only be shown in the storage split view (enabled with the DASHDOT_ENABLE_STORAGE_SPLIT_VIEW flag). The normal pie chart will not be affected and there will also be no disk shown in the list of the storage widget.

  • type: string (comma separated list)
  • default: unset

DASHDOT_DISABLE_INTEGRATIONS

Disables support for integrations. This does two things: disable CORS and disable open API endpoints.

  • type: boolean
  • default: false

Add / Remove / Rearrange Widgets and Labels

These options are passed as comma separated lists - you can remove and add widgets and labels.

DASHDOT_WIDGET_LIST

The available options are: os, cpu, storage, ram, network, gpu.

  • type: string (comma separated list)
  • default: os,cpu,storage,ram,network
os,cpu,storage,ram,networkram,cpu,storage,network
Dashboard in normal orderDashboard in alternate order

DASHDOT_OS_LABEL_LIST

The available options are: os, arch, up_since.

  • type: string (comma separated list)
  • default: os,arch,up_since

DASHDOT_CPU_LABEL_LIST

The available options are: brand, model, cores, threads, frequency.

  • type: string (comma separated list)
  • default: brand,model,cores,threads,frequency

DASHDOT_STORAGE_LABEL_LIST

The available options are: brand, size, type.

  • type: string (comma separated list)
  • default: brand,size,type

DASHDOT_RAM_LABEL_LIST

The available options are: brand, size, type, frequency.

  • type: string (comma separated list)
  • default: brand,size,type,frequency

DASHDOT_NETWORK_LABEL_LIST

The available options are: type, speed_up, speed_down, interface_speed, public_ip.

  • type: string (comma separated list)
  • default: type,speed_up,speed_down,interface_speed

DASHDOT_GPU_LABEL_LIST

The available options are: brand, model, memory.

  • type: string (comma separated list)
  • default: brand, model, memory

Widget Options and Styles