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-user and Group=console-user in console.service file with your local setup.
  • Ensure that CONSOLE_PBKDF_PASSPHRASE and CONSOLE_PBKDF_SALT are set to appropriate values.
  • Ensure that CONSOLE_MINIO_SERVER is set to appropriate server endpoint.