Systemd service for Console
November 6, 2025 ยท View on GitHub
Systemd script for Console.
Installation
- Systemd script is configured to run the binary from
/usr/local/bin/. - Systemd script is configured to run the binary as
console-user, make sure you create this user prior using service script. - Download the binary. Find the relevant links for the binary in the README or latest Release Page..
- DEB and RPM Packages will install the systemd service file to
/etc/systemd/system/minio-console.service.
Create the Environment configuration file
This file serves as input to Console systemd service.
$ cat <<EOT >> /etc/default/console
# Special opts
CONSOLE_OPTS="--port 8443"
# salt to encrypt JWT payload
CONSOLE_PBKDF_PASSPHRASE=CHANGEME
# required to encrypt JWT payload
CONSOLE_PBKDF_SALT=CHANGEME
# MinIO Endpoint
CONSOLE_MINIO_SERVER=http://minio.endpoint:9000
EOT
Systemctl
Download console.service in /etc/systemd/system/
( cd /etc/systemd/system/; curl -O https://raw.githubusercontent.com/georgmangold/console/main/systemd/console.service )
Enable startup on boot
systemctl enable console.service
Note
- Replace
User=console-userandGroup=console-userin console.service file with your local setup. - Ensure that
CONSOLE_PBKDF_PASSPHRASEandCONSOLE_PBKDF_SALTare set to appropriate values. - Ensure that
CONSOLE_MINIO_SERVERis set to appropriate server endpoint.