Create your own Geometry Dash private server: accounts, levels, music, Cloud Save and a web admin panel.
С чего начать — по-русски · Download · Website · Report a problem
Use PHP 8.2+ for a new server. Choose the row that matches your hosting:
| What you have | Where to start |
|---|---|
| Hosting with PHP 8.2+ and MySQL | Download the shared-hosting ZIP from Releases, upload its contents and open /install.php. Step-by-step guide |
| A Linux VPS and a domain | Point the domain to the VPS IP, then run the command below. PHP and the database are installed automatically. VPS guide |
| A 5v.pl site with PHP 7 | Use the separate PHP7 native preview. The PHP 8 archive will not run there. 5v.pl guide |
VPS installation:
curl -fsSL https://raw.githubusercontent.com/IZKGMD/GMDmucho-core/main/install-remote.sh | sudo bashThe installer selects a published stable release. Enter your administrator login and password, server name and domain when asked. Sign in at https://YOUR-DOMAIN/admin/ with the credentials you chose.
Direct VPS HTTPS remains the default. No Cloudflare API token, Global API Key, Cloudflare Tunnel or Cloudflare Proxy is required for this path.
For shared hosting, download MuchoCore-vX.Y.Z-shared-hosting.zip, not GitHub's source-code ZIP. The shared package includes the required dependencies. Create an empty database in your hosting panel before opening the installer.
- Open the admin panel.
- Open More tools → Clients & extensions → Web Client Patcher to create a client for your server. Keep your original game file. Windows and Android guide
- Launch the patched game, create a game account, then upload and download a test level. Your website administrator login is separate from your game account.
- Set up player downloads under More tools → Clients & extensions → Client Downloads before inviting friends. Publish only files you have permission to distribute.
Use the admin panel for players, levels, music and server settings. Additional technical tools are under More tools.
Use the updater, not first-time installation. Keep a backup of your database, settings and Cloud Save key before updating.
On a VPS:
sudo mucho update
sudo mucho doctorFor other hosting: PHP 8 shared updates · 5v.pl updates.
| Problem | First step |
|---|---|
| Installation cannot continue | Fix the failed hosting checks shown by the installer. |
| The website opens, but the game cannot connect | Check the client address and hosting routing using the client guide. A working website alone does not confirm game connectivity. |
| Login or level downloads fail | Include the client version and failing action in an issue. Never include passwords. |
| Moving an existing GDPS | Install into a fresh database, then use Migration Center. |
GD 2.209 support is still under verification; complete real-client acceptance is not certified. The PHP7 build is a development preview. Compatibility status
The source version is recorded in VERSION. A source version is not proof of a published stable release. Use Releases for published builds; main contains ongoing development.
Changelog · Local patchers · Plugins · Advanced networking · API · Go edition (in development)
Source code is in src/, HTTP entry points in public/, and checks in tests/. See tests/README.md for development validation.
MuchoCore and MuchoProtect are developed by IZK © 2026, with contributor and third-party rights respected. Source code: MIT. Geometry Dash and its assets belong to their respective owners. Website terms do not override the source-code license.