Skip to content

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 ​

ItemRequirement
Game runtimeopen.mp server; use matching builds for the host OS
CompilerPawn 3.10.10, pinned by pawn.json
Dependency managementsampctl installed separately
DatabaseMariaDB 10.5 or newer; the clean import has been checked on 10.5
Web and agentNode.js 22.12 or newer, npm and the supplied lockfiles
Game collision datascriptfiles/colandreas/ColAndreas.cadb, generated using your GTA installation
EmailYour own SMTP account or mail server
Production webDomain, 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 ​

RouteBest fitGuide
Linux + EasyPanelA hosted community with managed services, domains and persistent mountsEasyPanel
Windows standaloneLocal development, testing or a Windows hostWindows
Linux standaloneAdministrators managing services directly with systemdLinux
Docker or another panelExisting container infrastructureDocker

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.

Open-source roleplay foundations for open.mp. Bring your own world.