The installation takes about five minutes. You need:
- Root access to the 3CX server, in a terminal or over SSH.
- Your JEDWare license key, found on your user page at customer.jed-ware.com.
- 3CX v20 Update 6 or later on Debian 10 or later. See JEDWare requirements.
Still running JEDWare integration 4.x? Uninstall it first, then follow this guide.
Pick a quiet moment. The installer reloads Nginx on the 3CX server. The reload is graceful, but web client and app users can see a short reconnect. The full restart of the 3CX server we recommend at the end ends every active call, so install outside office hours, or skip the restart until the evening.
1. Download and unpack the installer
Create a folder for the installer, download it and unpack it. Keep the -U option: the download server refuses requests without it. The archive carries the executable bit, so there is nothing to make executable:
sudo mkdir -p /opt/JEDWareInstall
cd /opt/JEDWareInstall
sudo wget -U "JEDWare-Install/1.0" https://downloads.jed-ware.com/installers/Linux/JEDWare.Integration.tar.gz
sudo tar xzf JEDWare.Integration.tar.gz
2. Install the required packages
sudo apt update
sudo apt install -y libxrender1 libxext6 libfontconfig1
3. Run the installer
Start the installer and type your license key when asked. It checks the key, reads the 3CX domain from the Nginx configuration, downloads the current integration, adds the Nginx include, registers the JEDWare service and starts it:
sudo ./JEDWare.Integration
The last line reads Installation completed. If it stops earlier, the message says why: not running as root, license key invalid, 3CX domain not found in the Nginx configuration, or download failed. Run it again with --verbose for the full details.
If an earlier JEDWare integration was still running, the installer stops it first; it does not have to be uninstalled by hand.
4. What the installer did
Nothing to start by hand. The installer reloaded Nginx and enabled the JEDWare service, so it also starts after a reboot. Within three minutes the integration installs its updater service, and from then on the server updates itself when a new version is released.
We still recommend a full restart of the 3CX server afterwards, so every service starts in the right order.
5. Open JEDWare
Wait ten seconds, then sign in at app.jed-ware.com. The integration status in the app should say connected, and your extensions and queues appear in the reports.
If something does not work
- The app says No connection: see Why is my integration status No connection.
- A wallboard shows no data: see Wallboards don’t show up correctly.
- Later updates of the integration: see How to update your JEDWare integration.