Installation

First, create a file named /etc/default/dokku-pro. This file contains environment variables used to configure the service. The following are example variables:

API_JWT_ACCESSSECRET=asdfghjklzxc
API_JWT_REFRESHSECRET=qwertyuiopzxcvbnmas
ROOT_TOKEN=password
LICENSE_KEY=CONTENTS_OF_LICENSE_KEY

Create a folder called /etc/dokku-pro/ and create a file called /etc/dokku-pro/license.key. The contents of that file should be the previously downloaded license key.

Next, install the debian package distributed to you. This may be re-downloaded if necessary from the software distribution service:

dpkg -i path/to/dokku-pro.deb

The service is not started on boot. It can be started by running the following commands:

sudo systemctl daemon-reload
sudo systemctl start dokku-pro.target
sudo systemctl start dokku-pro.service
sudo systemctl enable dokku-pro.target

By default, the service starts on port 5000. See the Configuration documentation for more information on configuring this and other values.

Running in the dokku docker image

The debian package also installs a runit service at /etc/service/dokku-pro/run for use with the dokku docker image, which uses runit instead of systemd for service supervision. Create the /etc/default/dokku-pro file before installing the package, and runit will pick up the service automatically after installation.

The service can be managed via the sv command:

sv status dokku-pro
sv restart dokku-pro
sv stop dokku-pro

Log output is appended to /var/log/services/dokku-pro.