Requirements
Why Self-Host
Frona AI is designed to run on your own infrastructure. There’s no hosted version. You deploy and manage everything yourself. This gives you full control over your data, models, and configuration.
What you’ll deploy
Section titled “What you’ll deploy”A typical Frona installation includes:
| Service | Purpose | Required |
|---|---|---|
| Frona Engine | Rust backend. Agents, chat, tools, auth, database | Yes |
| Frona Frontend | Next.js UI. Chat interface, agent management | Yes |
| SurrealDB | Database (embedded, runs inside the engine) | Yes (built-in) |
| Browserless | Headless Chrome for browser automation | Recommended |
| SearXNG | Web search engine | Recommended |
| Twilio | Voice calls | Optional |
The database is embedded. SurrealDB runs inside the engine process using RocksDB as the storage backend. You don’t need to set up a separate database server.
Deployment options
Section titled “Deployment options”The simplest approach is Docker Compose. The repository includes a docker-compose.yml that starts all required services with a single command. This works well for:
- Personal use
- Small teams
- Development and testing
- Single-server deployments
For larger deployments, you can extract the individual containers and run them in Kubernetes or other orchestration platforms.
Getting started
Section titled “Getting started”Docker Compose
Configuration
Troubleshooting