Getting Started

Install

You need to build the CLI from source for now. Ensure cargo is installed for compiling the code.

Clone the unisrv-cli repo and run the install script — it builds the binary and puts it in ~/.local/bin:

git clone https://github.com/Unisrv/unisrv-cli.git
cd unisrv-cli
./install.sh

Then just make sure ~/.local/bin is on your PATH.

Login

unisrv login

You'll be prompted for your username and password. (only supported auth method for now)

Note: Credentials are stored in your system keystore. MacOS might prompt for permissions, especially if you rebuild the unisrv binary.

Verify it works

Run the hello-world container to confirm everything is connected:

unisrv instance run hello-world

🚀  Instance b033010c started successfully

Hello from Docker!
This message shows that your installation appears to be working correctly.
...

[Instance] 2026-02-28 14:13:47 - Container exited with code: 0