TrueCommand is available as a docker container and can run on any OS where docker is supported.
This repo provides some simple installation scripts for running a TrueCommand container as a system service, making it easier to start/stop/update the container as needed.
- Install your OS of choice or setup a pre-built VM image in your virtualization platform of choice.
- Follow the "Setup Guide" link below for your OS. Most setups are just 1-line commands.
This list is not exhaustive, please feel free to submit updates for other OS's as desired.
Note: Many pre-built Linux VM Images can be found here: linuxvmimages.com.
| OS | VM Images | Architecture | Instructions | Notes |
|---|---|---|---|---|
| Debian Linux | Download Site | amd64 | Setup Guide | Uses systemd service file |
| Alpine Linux | Download Site | x86_64 | Setup Guide | Uses OpenRC service file |
| Void Linux | Download Site | x86_64 | Setup Guide | Uses runit service file |
| Windows | Download Site | x64 | Setup Guide |
The install routines from this repo does the following:
- Setup a system service for running the TrueCommand docker container
- This service is enabled to auto-start on system boot
- Use your standard system service tools to manage the container (start, stop, restart, status, etc)
- The TrueCommand image has the following configuration by default:
- Starts the UI on ports 80 (http) and 443 (https)
- Stores the TrueCommand database at "/data" on the host
- Will use the "latest" TrueCommand docker image (latest official release)
- Turn off the service
- Edit the "start-truecommand" file (as root).
- This could be in the "/usr/local/bin" or "/usr/bin" directory, based on your host OS.
- All of the configuration options are right at the top of the file for easy-modification.
- Save the new file when you are done
- Turn on the service
For creating a setup script for some other OS, the setup comes down to 3 pieces:
- Ensure that docker is installed
- Install the "start-truecommand" file from this repository all/start-truecommand and a service file for your OS
- Enable the services