Skip to content
@retrogamehub

RetroGameHub

The online retro game management solution

๐ŸŽฎ retrogamehub.online

English | ไธญๆ–‡

retrogamehub.online is a self-hosted online retro game management solution, designed to help you organize, browse, and serve your retro game collection easily via the web.

Perfect for home servers, NAS devices, and retro gaming enthusiasts.


โœจ Features

  • ๐Ÿ“š Centralized management of retro game ROMs & media
  • ๐ŸŒ Web-based access
  • ๐Ÿณ Easy deployment with Docker
  • ๐Ÿ”’ Read-only resource mounting for safety
  • ๐Ÿ’พ NAS-friendly (Synology / Unraid / TrueNAS)

๐Ÿš€ Quick Start (Docker Compose)

1๏ธโƒฃ Prepare Resources

Create the following directory structure on your host machine:

retrogamehub/
โ”œโ”€โ”€ api
โ”œโ”€โ”€ media
โ””โ”€โ”€ roms

You can download a prepared resource package here:


2๏ธโƒฃ Docker Compose Configuration

Create a docker-compose.yml file:

services:
  retrogamehub:
    image: liuuyuunloong/retrogamehub:latest
    container_name: retrogamehub
    restart: unless-stopped
    ports:
      - "38283:80"
    volumes:
      - /volume1/Media/Game/retrogamehub:/app/res:ro
    environment:
      - NODE_ENV=production
    logging:
      driver: json-file
      options:
        max-size: "10m"
        max-file: "3"

โš ๏ธ Important

  • The mounted directory must contain api, media, and roms
  • The volume is mounted as read-only (:ro) to avoid accidental modification

3๏ธโƒฃ Start the Service

docker compose up -d

Then open your browser:

http://localhost:38283

๐Ÿ—‚ Directory Mapping

Host Path Container Path Description
retrogamehub/ /app/res Root resource directory
api/ /app/res/api API & metadata
media/ /app/res/media Covers & assets
roms/ /app/res/roms Game ROMs

๐Ÿ›  Environment Variables

Name Default Description
NODE_ENV production Runtime environment

๐Ÿ“ฆ Image Info

  • Image: liuuyuunloong/retrogamehub
  • Tag: latest
  • Platform: linux/amd64

๐Ÿ“„ License

TBD


๐Ÿ™Œ Acknowledgements

Built for retro gaming lovers who want simple deployment and clean management of their collections.

Popular repositories Loading

  1. .github .github Public

Repositories

Showing 1 of 1 repositories

People

This organization has no public members. You must be a member to see who’s a part of this organization.

Top languages

Loadingโ€ฆ

Most used topics

Loadingโ€ฆ