Skip to content

Server manual install

TTP Report edited this page Feb 17, 2025 · 1 revision

If quick install didn't work as intended or you want to tweak something along the way, here's what you need to do for a completely manual installation:

Install system dependencies

The only important dependency is mingw - it is required to cross-compile agent for Windows-based targets. You will need the toolchain itself, utils, headers and so on, the list is slightly different per distribution, but here's how it looks like for the most common ones:

Distro Dependencies
Debian-based (Debian, Ubuntu, etc) build-essential mingw-w64 binutils-mingw-w64 g++-mingw-w64
Redhat-based (Fedora, CentOS, RHEL) gcc gcc-c++ make mingw64-gcc
Arch-based (Manjaro, Garuda, Blackarch) mingw-w64-gcc mingw-w64-binutils mingw-w64-headers

Installing binaries

Fetch pre-compiled server binary from releases page or build it yourself.

It doesn't really matter where you put it, but let's say you put it in /usr/local/bin/ligolo-mp.

Running the server

Running the server will also automatically do the bootstrapping, like unpacking the assets or creating initial user, if required.

So, just run the server - use any service manager you prefer to run the binary with -daemon flag. Here's a sample systemd service config you can use:

[Unit]
Description=Ligolo-mp
After=network.target
StartLimitIntervalSec=0

[Service]
Type=simple
Restart=on-failure
RestartSec=3
User=root
ExecStart=/usr/local/bin/ligolo-mp

[Install]
WantedBy=multi-user.target

Next steps

You can start managing your server right away with the same server binary as it also includes the client:

sudo ligolo-mp

In the log pane you will notice that it failed to start agent and operator servers, but that's expected as they are running within a daemon - just proceed using the client as usual: take a look at admin panel overview to add additional users, for example or dive deeper into available server configuration options.

Clone this wiki locally