Deploy

The GitBook based NorthstarWiki has been replaced in favour of the NorthstarDocs where this wiki has been integrated.

Check it out here: https://docs.northstar.tf/Wiki/

The same page on the new wiki should be located here: https://docs.northstar.tf/Wiki/development/northstarmasterserver/deploy

Development

A Development Master Server uses http requests, it should be used for development purposes on your local machine.

Installation steps

1. Clone NorthstarMasterServer.

2. Copy the default dev.env to .env replace the ip with 127.0.0.1.

3. Run npm install && npm run watch.

Your master server is now running, to connect to it you need to change some configuration files.

Northstar default masterserver is https://northstar.tf, to point to a new location you need to modify this URL in the autoexec_ns_server.cfg and autoexec_ns_client.cfg config files.

Enabling HTTPS

HTTPS should be used if you plan for other people to use your master server. It can be enabled pretty easy with Caddy. Download a Caddy binary and create a Caddyfile with the following content:

{$SHORTDOMAIN:localhost} {
    reverse_proxy http://127.0.0.1:8080
}

After configuring your DNS domain you can run it with SHORTDOMAIN=example.com caddy run. Caddy will automatically generate and maintain your certificates for you, check its documentation for more info: https://caddyserver.com/docs/