Troubleshooting
Installation
Common situations met while preparing, installing and signing in to UNICONNECT AI, with the likely cause and the recommended resolution. Rows follow the order of the Installation guides, and the related guide is named on the left.
Five Checks to Make First
- Is the server on a supported system? Use Debian 12 or Ubuntu Server 22.04 LTS, or another recent Debian based distribution.
- Is the server large enough? The installer stops below 2 GB of RAM or 2 vCPUs. 4 vCPU, 8 GB of RAM and 100 GB of storage is the recommended size.
- Can the server reach the three endpoints? Outbound access is needed to activate.uniconnect.ai, release.uniconnect.ai and docker.com.
- Are the ports open? Port 5111 for the setup wizard, and 80, 443 and 445 for the platform.
- Do you have the license key? It arrives in the welcome email or the customer portal.
Symptoms, Causes and Resolutions
| Topic | Symptom | Likely Cause | Resolution |
|---|---|---|---|
| Operating System | The script does not continue after it checks the distribution. | The server does not run a Debian based distribution. The script is written for Debian based systems. | Provision the server with Debian 12, Ubuntu Server 22.04 LTS or another recent Debian based distribution, then run the script again. |
| Hardware | The Requirements step does not let you continue, or the installation cannot proceed. | The server has less than 2 GB of RAM or fewer than 2 vCPUs. | Resize the server, then click Re-run checks. Plan for the recommended size so that the deployment stays stable. |
| Hardware | The disk fills up over time. | Logs and call recordings need more space than the minimum storage. | Allocate additional storage from the start, ideally 100 GB or more. |
| Network | The installation or the license activation step does not complete. | A firewall blocks one of the required outbound endpoints. | Allow outbound traffic to activate.uniconnect.ai, release.uniconnect.ai and docker.com. |
| Dependencies | Docker is not installed after the script runs. | The script installs Docker through the convenience script from docker.com, and that endpoint cannot be reached. | Allow outbound access to docker.com, or install a modern, stable version of Docker Engine first. |
| Browsers | The setup wizard or the console does not display correctly. | The browser is older than the supported versions. | Use the latest two releases of Chrome, Firefox or Edge, or Safari 16 or later. |
| Ports | The setup wizard address does not open in the browser. | Port 5111 is blocked by a firewall. | Open port 5111, then use the Internet facing or Local network URL that the terminal printed. |
| Ports | The console cannot be reached after installation. | Ports 80, 443 or 445 are blocked, or they were changed on the Installation Configuration step. | Open the ports that were configured. The defaults are 80, 443 and 445. |
| Run the Script | The Native Linux Installation option cannot be used. | That option is marked Coming Soon. | Choose 1) Docker Installation (Recommended). |
| Setup Wizard | You cannot find the address of the setup wizard. | The terminal screen that printed it was closed or scrolled away. | Use the Internet facing or the Local network URL from the Setup Complete screen. Both use port 5111. |
| Requirements Check | One of the checks does not pass. | The server does not meet the requirement shown beside that check. | Resolve the underlying issue and click Re-run checks. Click Continue once all checks pass. |
| License Validation | The Validate button does not accept the key. | The key was typed incorrectly, or the server cannot reach the licensing endpoint. | Copy the key again from the welcome email or the customer portal, and check outbound access to activate.uniconnect.ai. |
| License Validation | You need to migrate an existing instance. | New Installation is selected, which activates with a license key. | Choose Restore from Backup instead. |
| Configuration | You want to use your own certificate. | For a UNICONNECT associated domain, a self signed TLS certificate is generated automatically. | Replace the certificate after installation. With a custom domain, upload your own SSL certificate on the Installation Configuration screen. |
| Installation Progress | You need to find where an installation phase failed. | The phases run automatically, so a problem is shown in the installation log. | Open the log, filter it to Issues, search for the phase, or click Copy log to share it with support. |
| Health Check | A service or an installation check does not show as healthy. | The service was still starting when the check ran. | Use Re-run on the item, and click View summary once you see All systems operational. |
| Activate Account | You did not click Open UNICONNECT Console after the installation. | Someone else ran the installation, or you continue in a later session. | Use the Set Password link in the license activation email. Both paths lead to the same screen. |
| Activate Account | The password is rejected. | It does not meet the listed rules. | Use at least 8 characters, with an uppercase letter, a lowercase letter, a number and a special character, and enter it the same way twice. |
| Sign In | You are not sure which button to use. | The login page offers several methods. | Use Login with Password for the administrator. Use Login with 3CX or Login with AD only where they apply. |
| Sign In | An account listed under Recent Login is not wanted. | It signed in on this device before. | Click the X on the card to remove it. |
Info: The full guides are System Requirements, Installation Guide and Getting Started.