Analytics cookies only (Google Analytics, PostHog). No ad networks, no cross-site tracking. See our privacy policy.
Self-host Gameyfin
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 web library for the game files on your server, inspired by Jellyfin: it scans folders of DRM-free games, fetches metadata and cover art through plugins, and lets you and your friends browse the collection and download games from the browser. Version 2 is a Kotlin and Spring Boot app with a React front end and an H2 database by default (PostgreSQL is an option), with user accounts, OAuth2/OIDC single sign-on and an optional torrent plugin. It does not launch or install games.
Pick Gameyfin when you keep DRM-free PC games on a server and want a Jellyfin-style web library for them: it scans your game folders, fetches metadata and cover art through plugins, and lets you and your friends browse the collection and download games from the browser. Version 2 is a Kotlin and Spring Boot app with a React front end and an H2 database by default (a PostgreSQL Compose example is also provided), licensed AGPL-3.0, and almost everything is configured in the admin UI instead of environment variables; the only required variable is `APP_KEY`. Our snippet is the Compose file from the Docker installation page with the image pinned to `2.6.0` (released 2026-10-28) and a generated `APP_KEY`. The installation page recommends a 1024 MB memory limit, which is our RAM floor. The catalog's RomM manages retro ROMs and plays them in the browser through EmulatorJS; Gameyfin is for PC game installers and archives, and it only serves them for download. GameVault, also in the catalog, adds a desktop client that installs and launches games.
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
Gameyfin's installation and configuration documentation flag these before you rely on it:
non-negotiableNothing is indexed until you finish the setup page, add a library folder and enable a metadata plugin. The bundled plugins are IGDB, Steam and SteamGridDB for metadata and Direct Download and Torrent for delivery, and the plugin page says to enable and configure each one. IGDB enforces rate limits, so large first scans are slow, and matching quality depends on how your folders and files are named.
non-negotiablePlugins run inside the same JVM as the application and are not sandboxed. The docs rank them as bundled, official (signed), community (unsigned) and untrusted, and Gameyfin shows the level but does not stop you installing any of them. Install community plugins only from authors you trust.
non-negotiableOur snippet mounts ./library as an example; mount your real game folders into the container and give the container user read access, since the FAQ lists permission problems as the first startup issue. If you run it behind a reverse proxy, websockets must work or scan progress and logs will not show in the UI, and set APP_URL for links in notification emails.
non-negotiableSign-ups are off by default and new users need admin confirmation, but the option to open libraries without login is a single setting, so check it before exposing the site. The optional torrent plugin needs ports 6969 and 6881 published, which our snippet leaves closed. The image's default JVM options cap the heap at 512 MB (-Xmx512m), and JAVA_OPTS_OVERRIDE replaces them.
Gameyfin used 437 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 Gameyfin install snippet verified?
The Gameyfin install snippet is marked verified on Ubuntu 26.04 (Nov 2026).