Portal & API

Install the Community portal

The Community portal is the control plane for your agents: sign-in, agent management, alerts, reporting, API keys, and license activation. It is free, open source, and runs entirely on your infrastructure. Paid features are unlocked with a license key from your TRIVLA account — the portal code is the same either way.

Requirements

• ✓ A 64-bit Linux server (2 vCPU / 4 GB RAM is plenty to start)
• ✓ Docker Engine 24+ and the Docker Compose plugin
• ✓ Outbound HTTPS (443) so the portal can validate licenses
• ✓ A domain or IP you can point your browser and agents at

Step 1 — Download the portal

Grab the latest release archive from your account downloads page and unpack it:

# Download and extract the Community portal
curl -fsSL https://releases.trivla.com/portal/latest/trivla-portal.tar.gz -o trivla-portal.tar.gz
tar -xzf trivla-portal.tar.gz
cd trivla-portal

Step 2 — Configure

Copy the sample environment file and set your secrets. The defaults work for a local trial; change the passwords and JWT secret before going to production.

cp .env.community.example .env
# edit .env: set JWT_SECRET and (optionally) SEED_ADMIN_EMAIL / SEED_ADMIN_PASSWORD

Step 3 — Start it

Use the startup script (Debian/Ubuntu and RHEL/CentOS/Alma/Rocky). It installs Docker on first run if needed, creates .env, brings up the stack, and waits for the health check:

chmod +x scripts/start.sh
sudo ./scripts/start.sh install-deps   # once per server
./scripts/start.sh start
./scripts/start.sh status

Or start manually with Compose:

docker compose up -d
docker compose ps        # wait until services report healthy

The portal is now serving on port 4000. Put it behind your reverse proxy (e.g. https://portal.example.com) for production.

Step 4 — Log in

Open the portal in your browser and sign in with the default administrator that was created on first start:

Email:    admin@trivla.local
Password: admin

Step 5 — Activate a license

From the portal, open Manage → Licenses:

• ✓ Community (free): click Get free Community key to generate a key with the core feature set and free agent seats.
• ✓ Professional / Enterprise: purchase a key from your account on trivla.com. Paste the key into your self-hosted portal and the paid features unlock instantly.

Step 6 — Connect your agents

Point each agent at your portal and apply a license key, then install agents per platform:

[portal]
url = https://portal.example.com/api/v1
license_key = trvl_xxxxxxxxxxxxxxxx