Skip to main content

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​

TopicSymptomLikely CauseResolution
Operating SystemThe 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.
HardwareThe 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.
HardwareThe 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.
NetworkThe 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.
DependenciesDocker 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.
BrowsersThe 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.
PortsThe 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.
PortsThe 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 ScriptThe Native Linux Installation option cannot be used.That option is marked Coming Soon.Choose 1) Docker Installation (Recommended).
Setup WizardYou 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 CheckOne 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 ValidationThe 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 ValidationYou need to migrate an existing instance.New Installation is selected, which activates with a license key.Choose Restore from Backup instead.
ConfigurationYou 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 ProgressYou 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 CheckA 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 AccountYou 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 AccountThe 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 InYou 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 InAn 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.