← Directory

Mousehole

Mousehole is a background service and web app that automatically keeps MAM up to date with your seedbox's current IP address.

  • Downloaders
  • Other
  • Productivity
  • Tools & Utilities
Mousehole is a background service and web app that automatically keeps MAM up to date with your seedbox's current IP address. It provides a management interface and API, and is useful for homelab users seeding from a host, VPN, or seedbox whose public IP is unstable.

Platform availability

Available on 1 of 9 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

69/100 Good

Maintained
97last commit 32 days ago
Popular
50305 GitHub stars
Easy to install
351 install platform, install notes, Docker image
Light to run
No data

Based on 3 of 4 factors.

Availability: platform listings confirmed today, links checked 10 days ago

GitHub stars
305
Open issues
10
Last commit
2026-09-11
Latest release
v0.5.0
Activity
stale

Checked 5 days ago - source: GitHub (t-mart/mousehole)

Resources & Compatibility

ARM (e.g. Raspberry Pi) is supported.

Checked 15 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Getting started Run Mousehole as a sidecar in your existing Docker Compose stack (the repo includes Gluetun and Wireguard + qBittorrent starter examples), then set your MAM cookie in the web UI to authenticate. source

Fetched 6 days ago - each note links to its source

Alternatives

No alternatives collected yet.

Common questions

Does Mousehole protect its cookie credential by default?

Mousehole has security features to protect the cookie credential, and most are enabled by default.

Are the default security settings enough when Mousehole runs on a custom domain or through a proxy?

No, the defaults will not be sufficient if you are running Mousehole on a custom domain or through a proxy.

Why can a broken network configuration make Mousehole fail?

Mousehole is often placed in configuration-heavy network setups, and if that network configuration is broken, then Mousehole is broken too.

How should I handle sustained network errors before opening an issue?

Use the network troubleshooting steps to find where the problem actually is before filing an issue.

Answers sourced from github.com, github.com

Community

Collected 14 days ago - public community threads