MC-Mod-Hub

MC-Mod-Hub

Docker app from allornothing's Repository

Self-hosted Minecraft mod/addon search hub.

Requirements

Optional but recommended: a free CurseForge API key (console.curseforge.com) and YouTube Data API v3 key (Google Cloud Console) — both entered from the admin portal after first boot, not required to install or run the container.
Overview
Self-hosted Minecraft mod/addon search hub. Aggregates search results from Modrinth, CurseForge, PlanetMinecraft, 9Minecraft, BetterBedrock, Hangar (PaperMC's official plugin repo), SpigotMC, TLMods (TLauncher's mod/modpack/resourcepack/map/shaderpack mirror), MinecraftSkins.net, Polymart (Spigot/Paper plugin marketplace), GitHub (repos tagged "minecraft", for mods and plugins with no listing anywhere else), MCreator.net, and McpeDude (Bedrock mods/addons/texture packs/maps) into one searchable list, styled after a familiar category-browser layout (category pills, an expandable "newest posts" notice board, a results table sortable and filterable by every column - name, source, edition, version, downloads, posted date, and last-updated date). Every result and every mod detail page shows the required game edition (Java or Bedrock), the game version(s) it supports, and when available the date it was first posted and last updated - read directly from each source's own API fields where one publishes them, and best-effort parsed from listing text on the scraped sites (which don't carry post/update dates at all - shown as a dash rather than a guess). Browse by category (Mods, Modpacks, Resource/Texture Packs, Data Packs, Shaders, Maps/Worlds, Bedrock Add-Ons, Server Plugins, Skins) without typing a search term, via category tiles or the sidebar. Each mod's detail page also surfaces community discussion pulled from Reddit (since none of these platforms expose a public reviews API) with heuristic fake-review flags - duplicate text, generic praise, suspicious posting bursts - and YouTube videos about the mod with download links automatically extracted from each video's description. CurseForge and YouTube API keys (both free, both optional but recommended) are entered and changed from the built-in admin portal after first boot at /admin.html - no file editing required, and no key ever needs to be baked into the container. Search results and the notice board are cached (configurable TTL) so repeat searches are instant and the scraped sites aren't hit on every page load. Optionally mount your Minecraft server's mods folder at /mods (off by default, one toggle in admin config) to unlock two more things: an "Install to my server" button on Modrinth/CurseForge/Hangar/ SpigotMC/GitHub results that downloads straight into that folder, and a "My Mods" update checker. Modrinth/CurseForge are identified by exact content hash (SHA1/murmur2, the same method their own official apps use, never filename guessing); Hangar/SpigotMC/GitHub have no public hash-lookup API, so anything installed through this app's own button is instead tracked by recording what was installed and re-checking that source directly.

MC Mod Hub

One search box for Minecraft mods, add-ons, packs, shaders, maps and skins. MC Mod Hub searches Modrinth, CurseForge, Hangar, SpigotMC, GitHub and about eight other sites at once and merges the results into a single table.

The good parts:

  • Everything in one table. Sort and filter by edition (Java or Bedrock), game version, downloads and dates.
  • Browse without typing. Category tiles for mods, modpacks, resource packs, shaders, Bedrock add-ons and more, plus a notice board of what's new.
  • Install to your server. Mount your server's mods folder and install or update mods with one click.

Image: allornothing/mc-mod-hub · Source: aon082910/mc-mod-hub

Install

Unraid: Copy templates/mc-mod-hub.xml into /boot/config/plugins/dockerMan/templates-user/, then Docker tab → Add Container and pick mc-mod-hub.

Docker:

docker run -d --name mc-mod-hub -p 8080:8080 \
  -v /mnt/user/appdata/mc-mod-hub:/data \
  allornothing/mc-mod-hub:latest
Setting Default What it's for
Port 8080 Web UI
/data /mnt/user/appdata/mc-mod-hub Database and saved keys
/mods none Optional: your Minecraft server's mods folder
ADMIN_PASSWORD admin First-login password. Change it right away
SESSION_SECRET auto Optional

First run

Open http://<unraid-ip>:8080/admin.html, log in, and change the password. Then paste in a CurseForge key and a YouTube Data API key if you want those sources. Modrinth, Hangar, Spiget and most others need no key. Keys live in the database, so you can swap them anytime.

Help

Open an issue. MIT licensed.

Categories

Download Statistics

1,497
Total Downloads

Related apps

Explore more like this

Explore all

Links

Details

Repository
allornothing/mc-mod-hub:latest
Last Updated2026-09-12
First Seen2026-09-01

Runtime arguments

Web UI
http://[IP]:[PORT:8080]/
Network
bridge
Shell
sh
Privileged
false

Template configuration

WebUI PortPorttcp

Port to access the web UI.

Target
8080
Default
8080
Value
8080
DataPathrw

Persistent storage for the settings/config database (API keys, source toggles, admin password).

Target
/data
Default
/mnt/user/appdata/mc-mod-hub
Value
/mnt/user/appdata/mc-mod-hub
Mods FolderPathrw

Optional: your Minecraft server's mods folder. Only needed for the &quot;Install to my server&quot; button and the update checker (both off by default — enable in admin config after mounting this). Leave blank to skip.

Target
/mods
SESSION_SECRETVariable

Optional: random string used to sign admin login sessions. Leave blank and the app generates and persists one on first boot — set this only if you want to fix it yourself (e.g. sharing a secret across multiple instances).

ADMIN_PASSWORDVariable

Initial admin portal password. Only used the very first time the container starts (before the database exists) — change it from within the admin portal afterward.

Default
admin
Value
admin