Skip to main content

Server and WSL

Use this guide if you are installing Cordatus on a server environment without a graphical desktop interface (for example, Ubuntu Server, WSL).
In this mode, Cordatus runs as a system service (daemon), managed by tools like systemd.

This setup is recommended when:

  • You are deploying Cordatus on a production server or cloud VM.
  • Your system does not have a GUI and is controlled entirely from the terminal.

If your device has a desktop interface but you prefer not to use it, see the Headless (CLI) guide instead.

Launching Cordatus Client​

After completing the base installation and restarting your device, if you chose to enable Cordatus to start automatically during installation, Cordatus will be running in the background. First, you need to stop the running Cordatus service to run the login command with your token:

sudo systemctl stop cordatus
info

Before you add a client device to the Cordatus platform, you must create a Cordatus account if you have not already done so. You can create a new account for free.

info

For Cordatus to establish a seamless connection with your device, Cordatus Client must be installed and actively running on your device.

Once you have registered and activated your account, you can add a device to the Cordatus platform. Keep in mind that to fully use the platform's features, you need an active Cordatus account.

Adding the Device​

info

Before adding a device, make sure you have already generated a token in the Cordatus Web App.
Follow the instructions in Generating Client Tokens to create your token.

After creating the token, run the following command in your client device's terminal with the --token parameter to add your device to the Cordatus platform:

cordatus --server --token=<your_token> --sudoPass:<your_sudo_password> --saveSudoPass

Once the connection between your device and the Cordatus platform is successfully established, Cordatus will proceed to configure your device and assign the associated license.

note

Cordatus requires sudo privileges for certain functions like device metric tracking. You can add sudo privileges and securely store your sudo password using the --sudoPass and --saveSudoPass parameters while adding your device. If you don't enter your sudo password during this step, you can enter it later anytime by using the same parameters.

info

You can check, stop, or start the Cordatus service by using the commands below:

sudo systemctl status cordatus   # check status  
sudo systemctl stop cordatus     # stop service  
sudo systemctl start cordatus    # start service  
sudo systemctl restart cordatus  # restart service