Downloading Manager Server

Create folder for Manager Server

mkdir /usr/share/manager-server

Download the latest version of Manager Server.

wget https://github.com/Manager-io/Manager/releases/latest/download/ManagerServer-linux-x64.tar.gz -O /usr/share/manager-server/ManagerServer-linux-x64.tar.gz

Then untar downloaded ManagerServer-linux-x64.tar.gz using following command

tar xvzf /usr/share/manager-server/ManagerServer-linux-x64.tar.gz -C /usr/share/manager-server

Install Manager Server as a service

Install the systemd service unit configuration file:

printf "[Unit]\nAfter=network.target\n\n[Service]\nLimitNOFILE=1048576\nExecStart=/usr/share/manager-server/ManagerServer -port 8080\nRestart=on-failure\nStartLimitInterval=600\n\n[Install]\nWantedBy=multi-user.target" | sudo tee /etc/systemd/system/manager-server.service

Reload the systemd daemon:

systemctl daemon-reload

And finally start Manager Server:

systemctl start manager-server

Also have the Manager Server service start automatically on boot so you don’t have to start Manager Server manually:

systemctl enable manager-server

Connecting to Manager Server

By default, Manager Server will listen on port 8080. Open your web-browser and navigate to http://127.0.0.1:8080 .

You should see login screen.

Default administrator password is empty so just click Login without entering any password.

Internet access

To access your Manager Server from the Internet, you will need to configure your router so it properly routes connections from the Internet into your computer running Manager Server. This is called port forwarding.

Custom domain

Instead of typing IP address, your users can type domain name instead. This will involve setting up A record on your domain so the domain name (or subdomain) points to IP address of your Internet router.

Setting up HTTPS

After you set up custom domain, it is highly recommended you secure Manager Server by HTTPS connection. This means your connection to your server will be encrypted. We recommend to use Caddy which will run on ports 80 and 443 and will automatically install SSL certificate for your custom domain.

Download Caddy using the following command:

wget https://github.com/caddyserver/caddy/releases/download/v2.2.0/caddy_2.2.0_linux_amd64.tar.gz

Untar Caddy.

tar xvzf caddy_2.2.0_linux_amd64.tar.gz

Move the caddy binary into /usr/local/bin/, for example:

sudo mv caddy /usr/local/bin/

Now let’s test reverse proxy with automatic HTTPS. Make sure to replace example.com with your domain name.

caddy reverse-proxy --from example.com --to 127.0.0.1:8080

After launching the the command, test in web-browser to access your domain. If it’s working, install the systemd service unit configuration file. Again, don’t forget to replace example.com for your domain name.

printf "[Unit]\nAfter=network.target\n\n[Service]\nLimitNOFILE=1048576\nExecStart=/usr/local/bin/caddy reverse-proxy --from example.com --to 127.0.0.1:8080\nRestart=always\nStartLimitInterval=600\n\n[Install]\nWantedBy=multi-user.target" | sudo tee /etc/systemd/system/caddy.service

And finally start Caddy:

systemctl start caddy

Also have the Caddy Server service start automatically on boot so you don’t have to start it manually:

systemctl enable caddy

Now, you don’t have to use 8080 port number when accessing Manager by your custom domain and your connection to Manager Server will be automatically encrypted by SSL certificate.

Upgrading Manager Server

Download the latest version of Manager Server:

wget https://github.com/Manager-io/Manager/releases/latest/download/ManagerServer-linux-x64.tar.gz -O /usr/share/manager-server/ManagerServer-linux-x64.tar.gz

Then untar downloaded ManagerServer-linux-x64.tar.gz using following command

tar xvzf /usr/share/manager-server/ManagerServer-linux-x64.tar.gz -C /usr/share/manager-server

Finally restart the service.

systemctl restart manager-server

Done. You can log into your server instance to verify the latest version is running.