Appearance
Choose your installation
Linux with EasyPanel is the recommended production arrangement. You can also run the complete framework without Docker on Windows or Linux. These guides assume you can install software, manage a database and administer your chosen host.
Common requirements
| Item | Requirement |
|---|---|
| Game runtime | open.mp server; use matching builds for the host OS |
| Compiler | Pawn 3.10.10, pinned by pawn.json |
| Dependency management | sampctl installed separately |
| Database | MariaDB 10.5 or newer; the clean import has been checked on 10.5 |
| Web and agent | Node.js 22.12 or newer, npm and the supplied lockfiles |
| Game collision data | scriptfiles/colandreas/ColAndreas.cadb, generated using your GTA installation |
| Your own SMTP account or mail server | |
| Production web | Domain, HTTPS and a supervised Node.js process or container |
The database connection uses MySQL-compatible protocols, but the supplied SQL includes MariaDB-specific migration syntax. Do not assume another database engine or version has been validated.
Pick a route
| Route | Best fit | Guide |
|---|---|---|
| Linux + EasyPanel | A hosted community with managed services, domains and persistent mounts | EasyPanel |
| Windows standalone | Local development, testing or a Windows host | Windows |
| Linux standalone | Administrators managing services directly with systemd | Linux |
| Docker or another panel | Existing container infrastructure | Docker |
Services you actually need
Run MariaDB, the game, the web application and the agent for the documented full setup. The agent owns the game process when using ACP start/stop. The additional Fastify API and external voice service are optional, not dependencies for normal UCP/ACP use.
Keep the database and agent on a private network. Players connect to the game port and the website; they do not need direct database or agent access. See ports and files.
Platform-specific considerations
Linux requires Linux .so plugins and the runtime libraries required by open.mp and each plugin. Windows .dll files cannot be reused. Native node-pty installation may need compiler/build tools when a suitable prebuilt package is unavailable.
The Windows build and local web flows have been exercised. Linux/EasyPanel instructions describe the intended deployment and still require a test on your target host. Resource requirements depend on players, world objects and enabled services; measure a private test server before sizing production.