Before we start

To edit the configuration, you need to understand how the YAML format works. It's pretty simple, and we have a brief guide below. If you're familiar with YAML, you can skip that.

Understanding the YAML Format

Configuration location

You can find the daemon configuration in /var/lib/wisp/daemon/config/wisp.yaml. After editing it, you'll need to restart the daemon to apply the changes with wisp restart.

Some changes require you to edit the docker configuration in /var/lib/wisp/docker-compose.yml

Using the beta branch

If you'd like to help us test daemon-specific features before they roll out to production, you can move to the beta branch on a specific node.

/var/lib/wisp/docker-compose.yml

environment:
- ENVIRONMENT: beta

Like any changes to the config files, you will need to reboot the daemon for them to take effect.

Changing WISP ports

You can change the default port of the daemon and SFTP in the node's admin area "Configuration" tab. This will automatically update the daemon's configuration to the new ports, but you'll need to manually update them if it fails. Like any changes to the config files, you will need to reboot the daemon for them to take effect.

/var/lib/wisp/daemon/config/wisp.yaml

web:
  listen: ...
sftp:
  port: ...

/var/lib/wisp/docker-compose.yml

services:
  bootstrapper:
    ports:
    - '8080:8080'
    - '2022:2022'

Changing console prefix

You can change the [WISP] prefix in the console when a server is starting up by adding the display_name key. You will need to reboot the daemon for changes to take effect.

/var/lib/wisp/daemon/config/wisp.yaml

display_name: "WASP"