How do I install the on-prem agent?

TL;DR: download the docker compose file from the onboarding wizard, run docker compose up -d, watch the dashboard light go green.

When to use the on-prem agent

Choose the agent if your osTicket is on a private network (behind a firewall, in a private VPC, or otherwise not reachable from the public internet). The agent runs alongside your osTicket as a small Docker container and connects outbound to Flexivity’s cloud — no inbound firewall rules required.

If your osTicket is reachable from the public internet, hosted mode is faster.

What you need

Docker and Docker Compose installed on the server hosting osTicket
Outbound HTTPS access (port 443) from the agent to the public internet
About 5 minutes

The 4-step install

Sign in to app.flexivity.ai and open the onboarding wizard.
Register your instance: give it a name, paste your osTicket URL, choose “self-hosted”.
Download the docker compose file that the wizard generates. It’s pre-filled with your instance ID, agent token, and verification key — no manual configuration needed.
Run it on your osTicket host:
```
docker compose up -d
```
The agent will start, connect to Flexivity, and report in. Watch the connection light on the wizard turn green — usually within 30 seconds.

What happens next

The agent starts polling osTicket for new tickets and pushes them through the AI pipeline.
AI summaries, recommendations, and classifications appear inside osTicket alongside each ticket.
The agent reconnects automatically if your network drops, and updates itself when we publish a new version (you can pin a version if you prefer).

Troubleshooting

Connection light stays grey: check docker logs fai-agent. The most common cause is the host blocking outbound port 443.
Agent connects but no tickets show up: verify the osTicket plugin is installed and active (the wizard walks you through this in step 2 of the install).
Anything else: see the full troubleshooting guide or email support@flexivity.ai.

Going deeper

Full agent setup guide — every option, every flag
Plugin installation — the osTicket-side companion
How agent updates work — auto-update, channels, version pinning