# mousehole

> Mousehole is a self-hosted service that keeps your MyAnonamouse seedbox IP updated automatically, with a web UI to manage the MAM cookie and trigger manual updates.

- **Category:** File Sharing
- **Latest version:** v0.5.0
- **Open source:** oss
- **Languages:** Typescript
- **Platforms:** Docker Compose
- **Tags:** Automation, Torrents, VPN, Seedbox, Ip updater, Private Tracker, Mam, Myanonamouse

## Description

Mousehole is a self-hosted tool for MyAnonamouse (MAM) users who run a seedbox or VPN with a changing IP address. It runs as a background service that periodically contacts MAM's dynamic seedbox API to update the registered IP, using a session cookie you provide. A web UI at port 5010 lets you paste the cookie, view the current IP and ASN, and trigger immediate updates. The project provides Docker images for amd64 and arm64, Docker Compose examples for common VPN + qBittorrent setups (including Gluetun, WireGuard, hotio, binhex), an Unraid template, and can be built from source with Bun. It supports password-protected browser login and Bearer token API authentication, with configurable host/origin allowlists for reverse proxy setups. State is stored in a file directory (default /var/lib/mousehole). No external database or cache is required.

## Links

- [Homepage](https://github.com/t-mart/mousehole)
- [Docker](tmmrtn/mousehole)
- [Repository](https://github.com/t-mart/mousehole)
- [Docker Hub](https://hub.docker.com/r/tmmrtn/mousehole)
- [API Documentation](https://raw.githubusercontent.com/t-mart/mousehole/master/docs/API.md)
- [Security Guide](https://raw.githubusercontent.com/t-mart/mousehole/master/docs/security-guide.md)
- [Getting Your Cookie](https://raw.githubusercontent.com/t-mart/mousehole/master/docs/getting-your-cookie.md)
- [Docker Compose Examples](https://raw.githubusercontent.com/t-mart/mousehole/master/docs/compose-setups.md)
- [Unraid Installation Guide](https://raw.githubusercontent.com/t-mart/mousehole/master/contrib/unraid/README.md)

---
Source: https://selfhost.directory/project/mousehole