Ubuntu

1Installing Prerequisite Software

Manager requires Mono to be installed on server. First, add the Mono Project GPG signing key and the package repository to your system:

apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys 3FA7E0328081BFF6A14DA29AA6A19B38D3D831EF

echo "deb https://download.mono-project.com/repo/ubuntu stable-bionic main" | sudo tee /etc/apt/sources.list.d/mono-official-stable.list

apt-get update

Then install Mono using following command:

apt-get install -y mono-complete

Once Mono is installed, it's time to download the latest version of Manager Server.

2Downloading Manager Server

Create folder for Manager Server

mkdir /usr/share/manager-server

Download the latest version of Manager Server.

wget https://d2ap5zrlkavzl7.cloudfront.net/19.2.62/ManagerServer.tar.gz -O /usr/share/manager-server/ManagerServer.tar.gz

Then untar downloaded ManagerServer.tar.gz using following command

tar -xzf /usr/share/manager-server/ManagerServer.tar.gz -C /usr/share/manager-server

3Install Manager Server as a service

Install the systemd service unit configuration file:

printf "[Unit]\nAfter=network.target\n\n[Service]\nLimitNOFILE=1048576\nExecStart=/usr/bin/mono /usr/share/manager-server/ManagerServer.exe -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

4Connecting 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.

5Internet 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.

6Custom 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.

7Setting 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 free edition of Caddy which will run on ports 80 and 443 and will automatically install SSL certificate for your custom domain.

Install Caddy using the following command:

curl https://getcaddy.com | bash -s personal

Then create Caddy configuration file which will instruct Caddy to act as a transparent proxy and pass all HTTPS requests to port 8080 where your Manager Server is running.

printf ":443 {\n proxy / localhost:8080\n tls { max_certs 100 }\n}\n" | sudo tee /usr/share/manager-server/caddy.conf

Install the systemd service unit configuration file:

printf "[Unit]\nAfter=network.target\n\n[Service]\nLimitNOFILE=1048576\nExecStart=/usr/local/bin/caddy -agree=true -conf=/usr/share/manager-server/caddy.conf\nRestart=always\nStartLimitInterval=600\n\n[Install]\nWantedBy=multi-user.target" | sudo tee /etc/systemd/system/caddy.service

And finally start Manager Server:

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.

8Upgrading Manager Server

Download the latest version of Manager Server:

wget https://d2ap5zrlkavzl7.cloudfront.net/19.2.62/ManagerServer.tar.gz -O /usr/share/manager-server/ManagerServer.tar.gz

Then untar downloaded ManagerServer.tar.gz using following command

tar -xzf /usr/share/manager-server/ManagerServer.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.

Support
Subscribe to Updates

Subscribe to our newsletter and get exclusive product updates you won't find anywhere else straight to your inbox.

Manager is rated 5 out of 5 by 35 reviewers
© 2019 - Based in Sydney, Australia but providing goodness globally