Contents
- Getting started
- Installing
- First setup and pairing the apps
- Lines and card readers
- Messages and calls
- Routing
- eSIM
- Compatibility list
- Network exits and proxy engines
- Hotspot and Wi-Fi
- Telegram bot remote control
- Status light (LED)
- Updates and backups
- Troubleshooting
- Users in the UK
- 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.
| System | Installer |
|---|---|
| Windows | CevixSetup-…-windows-….exe |
| macOS | Cevix-…-macos-….pkg |
| Debian, Ubuntu, Raspberry Pi OS, Armbian | cevix-gateway_…_….deb |
| Other Linux | cevix-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
- Double-click the installer and choose “Yes” in User Account Control.
- Accept the licence with “I Agree”.
- On the “Product key” page, paste your key, or tick “Enter it later on the web page”.
- 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”:
- macOS 14 and earlier: in Finder, right-click the file → Open → Open.
- macOS 15 and later: double-click it once and close the warning. In System Settings → Privacy & Security, scroll down and choose “Open Anyway”, then enter your password.
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.
sudo apt remove cevix-gateway: removes the program and keeps your data.sudo apt purge cevix-gateway: removes your data too. This cannot be undone.
Other Linux
chmod +x cevix-setup-<version>-linux-<CPU>
sudo ./cevix-setup-<version>-linux-<CPU>
410 stick and small boards
- Use the arm64 file.
- Do not add swap: it wears out the built-in storage.
- Keep Wi-Fi and ModemManager.
- Memory is small, so do not run many proxy exits at once; see Network exits.
Sign in right after installing
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.
- You need 1.3.6 or later. On an older version, update to 1.3.6 in 1.x first.
- Your administrator account, lines, settings, texts, call history and authorization come along. The phone apps do not need pairing again.
- Lines go offline for a while during the upgrade. Allow 15 minutes. Back up first.
- If the upgrade fails, the installer puts the old version back.
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