Requirements
Trakli is self-hostable. You run the Laravel backend and the Nuxt web UI on your own infrastructure, with your own database and your own keys. This page lists what you need before you start.
Components
Section titled “Components”A self-hosted Trakli is two services plus a database:
- Webservice: the Laravel backend. Holds the canonical data and exposes the REST API and the agent.
- Web UI: the Nuxt frontend. The browser dashboard. It talks to the webservice over the API.
- Database: MySQL or MariaDB.
The mobile app is a client. It does not need to be hosted; you point it at your backend’s API base URL.
Backend requirements
Section titled “Backend requirements”- PHP 8.2 or newer.
- Composer for PHP dependencies.
- MySQL or MariaDB for storage.
- The framework is Laravel 11, with Sanctum for token authentication.
Web UI requirements
Section titled “Web UI requirements”- Node.js (a current LTS or newer) and npm.
- The frontend is Nuxt 3 with Vue 3.
Agent requirements (optional)
Section titled “Agent requirements (optional)”The agent is part of the backend and is optional. To enable it you need an API key for a supported model provider. The agent layer is provider-agnostic through the eloquent-agents package, so you choose the provider and supply its key in configuration. Keep that key server-side. See Configuration and API keys.
A note on data ownership
Section titled “A note on data ownership”Self-hosting is the strongest form of the ownership promise: the data sits in your database, behind your auth, on your machine. The agent, when enabled, runs there too, and acts only on the data of the authenticated user.