A self-hosted TOTP code manager for development and testing.
Like MailHog, but for 2FA codes.
TOTPHog is a lightweight, self-hosted TOTP (Time-based One-Time Password) manager designed for development and testing environments.
Think of it like MailHog - but instead of catching emails, it manages TOTP codes. Perfect for testing 2FA flows without reaching for your phone.
⚠️ For development only - No authentication, tokens stored in plain JSON. Never use in production.
- 🔐 Generate valid TOTP codes from secret keys
- 📱 Import tokens from QR codes (otpauth:// URIs)
- 🖥️ Clean web UI with real-time code updates
- 🔌 Full REST API for automation
- 📊 QR code generation for exporting tokens
- 🐳 Single Docker container, zero config
docker run -d -p 8045:80 --name totphog damianovsky/totphog-
- Clone the repository
git clone https://github.com/damianovsky/totphog.git-
- Navigate to the project directory
cd totphog-
- Start the containers
docker compose up -dFull documentation is available in the `docs/` directory:
- Getting Started - Installation and setup
- API Reference - REST API documentation
- Configuration - Configuration options
- Architecture - Technical details
- OpenAPI Spec - Swagger/OpenAPI specification
MIT License - see LICENSE for details.
Made with 🐷 for developers who need TOTP codes without the hassle