Before running the server, there are some options you may want to tune. Those options can be specified either on the command-line or in a configuration file (that should be specified on the command-line).

Available options

Here are the three more important options:

This option allows to specify a configuration file in JSON format.
This option sets the environment to use. By default, the development environment is used. Unless you want to debug Dashkiosk, this is not what you want. You can use any other keyword. Use production if you don’t know.
The port to listen to. Quite important.

If you want to be able to use Chromecast devices, you also need to set:

Enable Chromecast support. Disabled by default.

The URL to the receiver. This is used to tell Chromecast devices where to find the receiver. The default value is unlikely to work. You should put the URL to access Dashkiosk and ends it with /receiver. For example, put something like This needs to be a fully qualified URL (including the protocol part http:// or https://).

If the reciever is on a server with only internal DNS records use the IP address of the server rather than URL. Chromecasts are hard coded to only use Google’s DNS servers ( and for lookups, rather than those given by DHCP.

The Chromecast custom receiver is hosted on GitHub. If you want to modify it or to host it yourself, you need to register a new application in the Google Cast SDK Developer Console and report the provided application ID as

The remaining options can usually be left untouched unless you decided to not use the integrated SQLite database.

Path where the static files to be served for the receiver and the integrated dashboards are located. Unless you moved them to some other location, there is no need to change this.
Database name. This is not needed if you kept the default SQLite database.
Username to access the database. This is not needed if you kept the default SQLite database.
Password to authenticate with the above username. This is not needed if you kept the default SQLite database.
Dialect to use for the database. This can be sqlite, mysql, mariadb or postgres.
Location of the SQLite database. Not used for other databases.
Hostname (or IP) where the database is located. This is not needed for SQLite.
Log level to use for logging messages. Use either info or debug.
Location of a log file where to write logs in JSON format. By default, no such file is generated.

Command-line or configuration file

On the command-line, the options are specified using the classic GNU long option style by prepending them with --. For example:

--port 8087 --environment production

Environment variables

You can also specify options using environment variables. In this case, substitute . by __ to get valid values:

$ export port=8088
$ export db__database=dashkiosk4

JSON configuration file

Alternatively, you can specify a JSON configuration file with --configuration. In this case, the options with a dot should be understood as being a sub-object. For example, to configure a PostgreSQL database:

    "environment": "production",
    "db": {
        "username": "dashkiosk",
        "password": "dashkiosk",
        "database": "dashkiosk",
        "options": {
            "host": "",
            "dialect": "postgres"
    "log": {
        "file": "/var/log/dashkiosk.log"

Reverse proxy

You may want to put a reverse proxy in front of Dashkiosk. You should know that it uses Socket.IO whose preferred backend is WebSocket. Some reverse proxy may not like it.

Here is a configuration for nginx:

upstream dashkiosk {
        server localhost:9450;
        server localhost:9451;

server {
   listen 80;
   listen [::]:80;

   location / {
     proxy_pass http://dashkiosk;
     proxy_http_version 1.1;
     proxy_set_header Upgrade $http_upgrade;
     proxy_set_header Connection "upgrade";
     proxy_set_header X-Forwarded-For $remote_addr;

Setting X-Forwarded-For header allows Dashkiosk to display the IP address of each display in case you want to log on it to debug it.