Analytics cookies only (Google Analytics, PostHog). No ad networks, no cross-site tracking. See our privacy policy.
GS
Self-host Gaseous Server
updated Nov 2026deployed by usprices checked · Jul 2026Install verified on Ubuntu 26.04 · Nov 2026 · how we test
We earn commissions when you shop through the links below. Full disclosure →
A self-hosted ROM and game-title manager: it scans your ROM folders, matches each file to an IGDB entry (cover art, screenshots, summaries) by hash signature, organises titles by platform, and lets you play supported systems in the browser through EmulatorJS, with save states and per-user accounts. A .NET server that stores its library in MariaDB.
Pick Gaseous Server when you want a ROM library with metadata and in-browser play on a small server and are happy to supply a free IGDB API key. It scans your ROM folders, matches files to IGDB titles using hash signatures (DAT files you import, or the Hasheous service if you switch it on), groups them by platform, and plays supported systems in the browser through EmulatorJS, with save states, BIOS handling and multiple user accounts. It is AGPL-3.0-licensed .NET. Our snippet is the project's own Compose file with the image pinned to `v1.7.14` and MariaDB 11 in a separate container; upstream calls separate containers the preferred layout and says the all-in-one `-embeddeddb` image's built-in MariaDB only updates when the image is republished, so we did not use it. We did not find an upstream RAM minimum, so our 1024 MB floor is an estimate. The catalog's RomM is the other self-hosted ROM manager, with more metadata providers; Gaseous is the lighter, IGDB-only option.
What you need
Any VPS with at least 1024 MB of RAM
A domain you control — most self-hosted setups need HTTPS in front of them
Gaseous Server's README and wiki flag these before you rely on it:
non-negotiableMetadata needs an IGDB key: the wiki lists a Twitch developer account with two-factor authentication, a registered application and a client id plus secret as a prerequisite for all deployment types. Our snippet writes empty IGDB_CLIENT_ID and IGDB_CLIENT_SECRET lines into .env; fill them in and run docker compose up -d again, otherwise titles will not get cover art or summaries.
non-negotiableAuthentication exists from 1.7.0 onwards, but the README still advises against exposing the server to the internet unless you actively need remote access, and recommends a VPN where you have one. Port 5198 serves plain HTTP, so put a TLS reverse proxy in front of it if you do publish it.
non-negotiableLibrary state lives in two volumes: gs for the server's data directory (/root/.gaseous-server, which holds config.json and uploaded content) and gsdb for MariaDB. Back both up. The upstream compose uses gaseous as every password; ours generates one into .env, so keep that file out of version control. Version 2 moves the data directory to /home/gaseous/.gaseous-server, so check the wiki before moving past 1.x.
non-negotiableThe wiki's examples use the latest tag; Docker Hub also carries a tag per release, and we pin v1.7.14 (published 2025-07-31). Version 2 is still a release candidate, so we did not use it. The README names MariaDB 11.1.2 as the preferred database (MySQL 8 or later also works) and says moving from MySQL to MariaDB means rebuilding the database.
Gaseous Server used 264 MB of RAM at idle on GCP e2-standard-2 · Ubuntu 26.04 LTS · Docker 29.9.3 (first boot, measured Nov 2026). We list a minimum of 1024 MB.
Is the Gaseous Server install snippet verified?
The Gaseous Server install snippet is marked verified on Ubuntu 26.04 (Nov 2026).