Installer options
The install commands ask one or two questions as they run. Their options answer them in advance, so a script can install the server with no one at the keyboard.
The Linux installer
The standalone install command asks two questions: Start the server at boot (Y/n)? and Keep the server up to date by itself (Y/n)?. Enter picks the capital letter: yes on a new install, and on a server installed before, what it does now.
| Option | What it does |
|---|---|
-q | No questions. Without the two options below, a new install starts at boot and updates itself, and a server installed before keeps its choices. |
-noautostart | Answers no to the first question: the server does not start at boot. A new install then has no service, so you start the server yourself. |
-noautoupdate | Answers no to the second question: the server does not update itself. |
-help | Lists the options, and installs nothing. |
Options go at the end of the install command, inside its quotes.
For example, in a script, with no questions
sudo su -c "bash <( wget -qO- https://github.com/vpnhood/VpnHood.App.Server/releases/latest/download/VpnHoodServer-linux.sh) -q"To change an answer later, run the install command again, without -q, and give the new answer. The server keeps its settings and access keys, and is updated to the latest release.
The Docker installer
The Docker install command asks one question: Install Docker (y/n)?. Type y to have it install Docker and its compose plugin, which it can do on Ubuntu, Debian and the distributions based on them, or n if the machine has them already.
| Option | What it does |
|---|---|
-install-docker | Answers yes to the question: installs Docker and its compose plugin, unless the machine has them already. |
-q | No question: Docker is installed only with -install-docker.
|
For example, in a script, installing Docker too if the machine does not have it
sudo su -c "bash <( wget -qO- https://github.com/vpnhood/VpnHood.App.Server/releases/latest/download/VpnHoodServer.docker.sh) -install-docker -q"Options MANAGER fills in
Both installers also take -httpBaseUrl, -httpAuthorization and -managementSecret. They replace the server's /opt/VpnHoodServer/storage/appsettings.json with one that connects it to VpnHood! MANAGER, which makes it a managed server. You do not type them: the install command MANAGER shows for a server has them filled in, as Add a server shows.
The uninstaller
The uninstaller of a server installed without Docker takes one option, -purge, which deletes the server's settings, access keys and certificates too. See Uninstall.
Next steps
- Create the access keys your devices connect with, on Linux or in Docker
- Set the IP addresses the server listens on and puts in its keys
- Use a domain name and a trusted certificate
- Keep your server's IP address from being blocked
