Contents
  1. Getting started
  2. Installing
  3. First setup and pairing the apps
  4. Lines and card readers
  5. Messages and calls
  6. Routing
  7. eSIM
  8. Compatibility list
  9. Network exits and proxy engines
  10. Hotspot and Wi-Fi
  11. Telegram bot remote control
  12. Status light (LED)
  13. Updates and backups
  14. Troubleshooting
  15. Users in the UK
  16. Comparison with other tools

Docs / 02

Installing

There are installers for Windows, macOS and Linux. The same installer does a fresh install or an upgrade from 1.x. If any step fails, it puts everything back.

Pick the installer

Download the installer from where you got Cevix, or ask your seller for it. Pick the file for your system and CPU: a regular PC or an Intel Mac is amd64; an Apple silicon Mac, a Raspberry Pi, an Armbian board or the 410 stick is arm64.

SystemInstaller
WindowsCevixSetup-…-windows-….exe
macOSCevix-…-macos-….pkg
Debian, Ubuntu, Raspberry Pi OS, Armbiancevix-gateway_…_….deb
Other Linuxcevix-setup-…-linux-…

Once installed, open https://<this machine’s address>:8443 in a browser. On the same machine, that is https://localhost:8443. The first time, the browser warns about the certificate; check that it is your machine and continue. Then see First setup.

Windows

  1. Double-click the installer and choose “Yes” in User Account Control.
  2. Accept the licence with “I Agree”.
  3. On the “Product key” page, paste your key, or tick “Enter it later on the web page”.
  4. At the end you can tick “Open the Cevix web interface”.

Later, open the web interface from the Cevix Gateway folder in the Start menu. To remove it, uninstall Cevix Gateway in Windows Settings → Apps.

SmartScreen and antivirus

The installer has no code signature, so Windows shows “Windows protected your PC”. Choose “More info” → “Run anyway”.

Some antivirus programs show a reputation warning. Choose to trust the program, or add C:\Program Files\CevixGateway and C:\ProgramData\CevixGateway as exceptions. If the install was blocked halfway, add the exceptions and run the installer again.

If Windows Firewall blocks port 8443, add a rule yourself.

macOS

The installer is not signed or notarised by Apple, so the first time macOS says it is “from an unidentified developer”:

Then choose Install and enter your password. When it is done, the browser opens the web interface.

Linux

Debian package (recommended)

For Debian 12 or later, Ubuntu 22.04 or later, Raspberry Pi OS and Armbian:

sudo apt install ./cevix-gateway_<version>_<CPU>.deb

Keep the leading ./. The install asks for the product key; leave it empty to enter it later on the web page.

Other Linux

chmod +x cevix-setup-<version>-linux-<CPU>
    sudo ./cevix-setup-<version>-linux-<CPU>

410 stick and small boards

Sign in right after installing

Important

Until you create the administrator, anyone who can reach this machine can create one. Finish First setup straight away.

Upgrading from 1.x

To go from 1.x to 2.0, use the installer. Do not upload the 2.0 update package in the 1.x web page; it says the signature does not match.

Once you are on 2.0, later updates are done in the web interface; see Updates and backups.

Handy commands

In a Linux or macOS terminal, or a Windows Command Prompt run as administrator:

cevix status            # version, services, address
    cevix open              # open the web interface in a browser
    sudo cevix restart      # restart (also start, stop)
    sudo cevix update apply # install the latest official update

Written for Cevix 2.0.4.