gaseous-server
A self-hosted server that manages your ROM collection and lets you play classic games directly in the browser via EmulatorJS integration.
Smart Download
Visit Project Homepage
No installer available yet — head to the source repository
Self-hosted ROM manager with browser emulation – play retro games instantly.
Core Features
- Automatic metadata fetching from IGDB or Hasheous proxy
- Built-in browser-based emulation using EmulatorJS (RetroArch cores)
- User authentication for secure remote access (v1.7.0+)
- Docker support for easy deployment
- Library scanning and signature import for accurate game identification
What It Can't Do
- •Migrating from MySQL to MariaDB requires a full database rebuild; 2. Exposing to the internet without enabling authentication is a security risk; 3. Initial library scan can be slow for large collections.
Use Cases
- Personal retro game library organization and remote play
- Shared family or friend group game server
Detailed Introduction
Gaseous Server is a self-hosted ROM management and emulation server. It organizes your game ROMs, automatically fetches metadata from IGDB (or uses a Hasheous proxy), and provides a web-based interface for browsing and playing games. Built on .NET, it integrates EmulatorJS to run RetroArch cores in the browser, supporting a wide range of platforms. Version 1.7.0+ includes user authentication for safe internet exposure, though caution is advised. The server requires MariaDB/MySQL and ffmpeg. It stands out by combining library management with instant browser play, eliminating the need for separate emulator clients.
Troubleshooting & FAQ (1)
TroubleshootingWhy are all libraries missing from the Gaseous UI after adding a new library with a file path?
This happens when the directory path you provided for the new library already exists as a file. Gaseous internally calls Directory.CreateDirectory() for each library path on startup. If a file exists at that path, the operation fails with an IOException, which disrupts the loading of all libraries and makes them disappear from the UI. To fix it, delete the conflicting file (e.g., /games/roms/nintendo/snes) or move it elsewhere, then restart the Gaseous server container. After restart, all libraries should reappear, and you can add the library with the correct directory path.
Tags
Getting Started
Download installer
Click the button above to download the installer for your system
Install the software
Double-click the downloaded installer and follow the prompts
Step 1: Install MariaDB 11.1.2+ (recommended) or MySQL 8+, and ffmpeg
Step 2: Obtain an IGDB API key or configure the Hasheous proxy
Step 3: Run the server via Docker (gaseous-project/gaseous-server) or build from source
- Step 1: Install MariaDB 11.1.2+ (recommended) or MySQL 8+, and ffmpeg
- Step 2: Obtain an IGDB API key or configure the Hasheous proxy
- Step 3: Run the server via Docker (gaseous-project/gaseous-server) or build from source
Checksum not available
This project has not published a SHA-256 checksum on its GitHub Release page
SHA256 Checksum
No checksum available
Download directly from GitHub Releases and verify file integrity yourself
All SHA-256 checksums on this platform are extracted from the project's official GitHub Release page, without any modification. You can independently verify them on the GitHub Releases page.
Open Source Transparency
View GitHub SourceUninstall Info
Stop the service, remove Docker container/image (or delete installation directory), and optionally drop the database to fully remove.
No Extra Dependencies
Ready to use after download. No additional runtime required.
Having issues? Check the FAQ below
1 FAQ
Similar Projects
yt-dlp
A feature-rich command-line audio/video downloader supporting thousands of sites. Fast, reliable, and actively maintained fork of youtube-dl.
MoneyPrinterTurbo
An open-source tool that uses AI LLMs to automatically generate high-quality short videos from a topic or keyword.
obs-studio
Free and open-source software for video recording and live streaming. High performance, real-time capture, compositing, encoding, and broadcasting.