Server configuration

Skybrush Server is configured through a human-readable .jsonc or .toml configuration file.

The default configuration file used by the server can be found in the root directory of the server. The exact location is logged by the server terminal upon startup.

If you run your server instance from the command line, you can provide an arbitrary path for your custom server configuration file with the -c command line option (run with --help to get more details).

You can also find sample configuration files for different systems (outdoor, indoor, etc.) in the etc/conf/ folder of the source code on GitHub.

Changing server configuration

You have two options for setting up your configuration file:

  1. If you are an advanced user and know what you are doing, you can edit the configuration file directly.

    Do not forget to restart your server after changing the configuration file.

  2. There is a dedicated UI for monitoring and changing server configuration at localhost:5000, as described in more detail in the following sections.

Initial setup for different use-cases

In the following sections we will go through the most common use-cases in terms of number of drones and network infrastructure and give an initial setup guide for configuring Skybrush Server. The following guides are available: