To install the Client on your workstations:
-
Clone this repository to a permanent location on your workstation; Navigate to the project root directory.
-
Prepare a Python virtual environment for the Client:
python3 -m venv venv source venv/bin/activate pip install -r requirements.txt -
Ensure that you have modified the config file to specify the server address.
-
Dry-run the installation:
./client/installer
Check the output of the dry-run to verify that the installation script is able to detect the correct Python virtual environment.
-
Run the actual installation:
./client/installer install
The installation script will create a systemd service to run the Client in the background. The service will be started automatically when the workstation boots up.
Check the status of the Client service:
sudo systemctl status MXShellClientTo restart the Client service, run:
sudo systemctl restart MXShellClientTo check the system logs of the Client, run:
sudo journalctl -u MXShellClientTo remove the Client from a workstation, run:
./client/installer uninstall