Installing

A single command turns a fresh Ubuntu server into a running Voiplix installation. Here is what to run and what to expect while it works.

Make sure you have what System requirements lists first: the server itself, a domain, and your installation code.

1. Log in to the server

Connect to your fresh server over SSH as root.

2. Run the installer

The installer is a single script, published at releases.voiplix.com. Either download it and run it:

wget -qO install.sh https://releases.voiplix.com/install.sh
bash install.sh

...or run it directly as a pipe:

curl -fsSL https://releases.voiplix.com/install.sh | bash

Both do the same thing — the pipe form still asks its questions in your terminal.

Tip

For an unattended install (no questions asked), pass the installation code, domain and e-mail as arguments:

bash install.sh --code VOIPLIX-XXXX --domain billing.yourdomain.com --email you@yourdomain.com

3. Answer the three questions

If you did not pass them as arguments, the installer asks for them directly:

Question	What it's for
Installation code	Identifies your license with Voiplix. Checked online before anything is installed; the installer stops here if it isn't valid.
Domain	The address you and your customers will use, e.g. `billing.yourdomain.com`.
E-mail (optional)	Only used for the HTTPS certificate (renewal notices). Press Enter to skip it.

4. Let it run

From here everything is automatic. In plain terms, the installer:

Checks the installation code online.
Installs system packages and sets up the firewall.
Installs Node.js, PostgreSQL and the other components Voiplix runs on.
Builds Asterisk (the telephony engine) from source — the slowest step.
Downloads the current Voiplix release and checks its checksum before unpacking it, so a damaged or incomplete download is never installed.
Sets up the database and builds the application.
Configures Asterisk for the new server.
If the domain already resolves to this server: requests an HTTPS certificate automatically.

Note

Expect around half an hour to an hour, most of it Asterisk compiling. The terminal keeps printing progress the whole time — a quiet terminal for a few minutes during the Asterisk step is normal, not a hang.

5. The finish message

When it is done, the installer prints a boxed message with a one-time setup link, of the form:

https://billing.yourdomain.com/setup?token=<a long random token>

Warning

This link only works until setup is completed. Open it right away and finish the wizard — see First start and setup.

If the domain did not resolve to the server in time for the automatic certificate, the same message tells you so and gives you the one command to run afterward once DNS has caught up — the setup link works over plain HTTP in the meantime.

Check

The install finished successfully if you see the boxed "installation complete" message with a setup link. If it stopped earlier with a red [FEHLER]/error line instead, nothing further was installed — the message above it says what was missing (most often: an invalid installation code, or too little free memory).