Home
Softono

Gaseous Server

Open source Docker
895
Stars
31
Forks
69
Issues
7
Watchers
3 months
Last Commit

 About Gaseous Server

Game ROM manager with a built-in web-based emulator using multiple sources to identify and provide metadata.

Platforms

Web Self-hosted Docker

Languages

Docker

Need Help Installing Gaseous Server?

We provide expert installation service for this software. Our team will install, configure, and secure Gaseous Server on your server. plans start at just $30.

Gaseous Server

View on GitHub

.NET Nightly Build Release Docker Image

Gaseous Server

This is the server for the Gaseous system. It offers ROM and title management, as well as some basic in browser emulation of those ROMs.

Version 1.7.0 and later contain user authentication, and can be exposed to the internet. However, it is recommended to not expose the server to the internet if you're not actively using it remotely, or if you have alternative means to access it remotely like a VPN.

While we do our best to stay on top of server security, if you expose the server to the internet you do so at your own risk.

Screenshots

Library Game Emulator

Requirements

  • MariaDB 11.1.2+ (preferred) or MySQL Server 8+
    • These are the database versions Gaseous has been tested and developed against. Your mileage may vary with earlier versions.
    • MariaDB is the preferred database server, while MySQL will continue to be supported for existing users (they should be interchangable).
    • Note that due to the earlier database schema using MySQL specific features, moving to MariaDB from MySQL will require rebuilding your database from scratch. The "Library Scan" background task can be used to re-import all titles.
  • ffmpeg
  • Internet Game Database API Key. See: https://api-docs.igdb.com/#account-creation - only required when not using the Hasheous proxy

Installation

See https://github.com/gaseous-project/gaseous-server/wiki/Installation for installation instructions.

Adding Content

  1. (Optional) Import signatures: see https://github.com/gaseous-project/gaseous-server/wiki/Signatures
  2. Add ROMs: see https://github.com/gaseous-project/gaseous-server/wiki/Adding-ROMs

Friends of Gaseous

Discord Server

Join our Discord server: https://discord.gg/Nhu7wpT3k4

Tests

Run unit tests locally:

dotnet test gaseous-server.Tests/gaseous-server.Tests.csproj

The test suite covers:

  • JSON and binary response handling in HTTPComms.SendRequestAsync
  • Retry-After parsing and retry behavior
  • Cancellation token behavior