Supported Platforms
This page lists the platforms, versions, and system requirements for running Flexivity AI.
osTicket
Flexivity AI supports the following osTicket versions:
| Version | Status |
|---|---|
| osTicket 1.18.x | Fully supported |
| osTicket 1.17.x | Fully supported |
| osTicket 1.16.x and earlier | Not supported |
The Flexivity AI plugin requires osTicket’s signal system for event capture. Versions prior to 1.17 lack the necessary signal hooks.
PHP
The plugin requires PHP 8.1 or higher. This aligns with osTicket’s own requirements for versions 1.17 and 1.18.
| PHP Version | Status |
|---|---|
| PHP 8.3 | Supported |
| PHP 8.2 | Supported |
| PHP 8.1 | Supported (minimum) |
| PHP 8.0 and earlier | Not supported |
Database
Flexivity AI does not require any changes to your helpdesk database schema beyond what the plugin installer creates automatically. The plugin adds its own tables (prefixed with fai_) to the application database. No manual migration steps are needed.
The plugin is compatible with:
| Database | Status |
|---|---|
| MySQL | 5.7 or later — fully supported |
| MariaDB | May work but not officially tested or supported |
Docker (On-Premise Agent)
The Flexivity AI agent runs as a Docker container. The following Docker versions are required for self-hosted deployments:
| Component | Minimum Version |
|---|---|
| Docker Engine | 20.10 or later |
| Docker Compose | v2 (Compose plugin) |
Docker Compose v1 (standalone docker-compose binary) is not officially supported. If you are using Docker Compose v1, upgrade to the Compose plugin (docker compose as a subcommand).
Resource Requirements
The agent container is lightweight. Recommended minimums:
| Resource | Minimum | Recommended |
|---|---|---|
| CPU | 1 vCPU | 2 vCPU |
| Memory | 512 MB | 1 GB |
| Disk | 2 GB (container images) | 5 GB |
| Network | Outbound HTTPS (port 443) | Outbound HTTPS (port 443) |
The agent includes PII detection and scrubbing capabilities, which account for most of the memory and disk footprint.
Operating Systems (Agent Host)
The Docker-based agent can run on any operating system that supports Docker Engine.
| OS | Status | Notes |
|---|---|---|
| Linux (Ubuntu, Debian, RHEL, Amazon Linux) | Recommended | Native Docker support, lowest overhead |
| macOS | Supported | Requires Docker Desktop |
| Windows | Supported | Requires WSL2 with Docker Desktop |
Linux is recommended for production deployments due to native container support and lower resource overhead. macOS and Windows are fully supported for development and testing environments.
Admin Console (Browser)
The Flexivity AI admin console is a web application that runs in modern browsers. The following browsers are supported:
| Browser | Supported Versions |
|---|---|
| Google Chrome | Latest 2 major versions |
| Mozilla Firefox | Latest 2 major versions |
| Apple Safari | Latest 2 major versions |
| Microsoft Edge | Latest 2 major versions |
JavaScript must be enabled. The admin console does not support Internet Explorer.
Network Requirements
Self-Hosted Agent
The agent requires outbound network access to the Flexivity AI cloud and local network access to your helpdesk instance. No inbound firewall rules from the internet need to be configured.
| Direction | Protocol | Port | Source / Destination |
|---|---|---|---|
| Agent → Helpdesk | HTTPS (TLS) | 443 | Agent must reach your helpdesk instance over HTTPS |
| Agent → Cloud | WSS (WebSocket over TLS) | 443 | Agent connects outbound to *.flexivity.ai |
If your network uses an HTTP proxy for outbound traffic, the agent supports standard HTTPS_PROXY environment variable configuration.
Direct Connection (Hosted Mode)
In direct connection mode, the Flexivity AI cloud service needs to reach your helpdesk instance over HTTPS. Your helpdesk installation must be accessible from the internet (or accessible from AWS IP ranges if you use IP allowlisting).
| Direction | Protocol | Port | Source |
|---|---|---|---|
| Inbound | HTTPS | 443 | Flexivity AI cloud (AWS IP ranges) |