Install your hotel

Use the PlusEMU installer to set up the game server, Volt client, Atom CMS website, MariaDB, and hotel assets together.

Prepare a server

Start with a fresh server. The installer changes the web server, database, and firewall configuration.

Requirement	Linux	Windows
Operating system	Debian 12 or 13; Ubuntu 22.04, 24.04, or 26.04	Windows Server 2019, 2022, or 2025
Architecture	x64 or ARM64	x64
Free disk space	10 GB	15 GB on C:
Access	Root or sudo	PowerShell as Administrator

Have a domain and a Cloudflare account ready. The installer generates the instructions for your domain after installation.

Run the installer

On Linux, run:

curl -fsSL https://raw.githubusercontent.com/plus-emulator/plusemu-installer/main/install.sh | sudo bash

On Windows, open PowerShell as Administrator and run:

irm https://raw.githubusercontent.com/plus-emulator/plusemu-installer/main/install.ps1 | iex

Both commands download and run the installer. To read the script first, download install.sh or install.ps1 from the installer repository. Then run sudo bash install.sh on Linux, or .\install.ps1 in an Administrator PowerShell on Windows.

Answer the prompts for your domain, WebSocket address, hotel name, admin username, and admin email. Keep the suggested WebSocket address, wss://your-domain/ws, unless your setup needs a separate hostname.

Save the initial admin login details shown at the end. The installer also saves its answers and credentials in a protected local file.

Connect your domain

Open the setup guide that the installer prints or opens. On Linux, the installer prints a private address like http://<server IP>/<token>/. The token is random. On Windows, the guide opens in your browser, and a copy named Hotel setup guide is saved on the desktop.

Follow that guide to:

1. Add the domain to Cloudflare and change its nameservers.
2. Add the proxied DNS records for your server.
3. Generate a private key and certificate-signing request on the server.
4. Request a Cloudflare Origin CA certificate and install the signed certificate on the server.
5. Set Cloudflare SSL/TLS to Full (strict) and turn on Always Use HTTPS.
6. Check that WebSockets are enabled.

Install the origin certificate before selecting Full (strict). The installer starts with a temporary self-signed certificate. Keep the private key on the server and paste only the certificate-signing request into Cloudflare.

Check your hotel

1. Open https://your-domain and sign in with the initial admin account.
2. Change the initial password.
3. Open the client and enter a room.
4. Open https://your-domain/housekeeping to manage the website.

If installation stops, read the error in the installer log, fix its cause, and rerun the same command. The installer reuses your saved answers and keeps the parts that are already installed.

For Cloudflare connection errors, use the troubleshooting section in the generated guide. It contains the paths and commands for your server.

Next steps

Read configuration for file locations and service commands. Camera rendering needs a separate setup.

For an emulator-only installation, use the PlusEMU release archives and the manual setup instructions. The archives are self-contained and do not require a separate .NET installation.