OTP Manager

🔐 Enterprise-Grade One-Time Password Management

Streamline OTP distribution and tracking for teams, organizations, and families

Overview

OTP Manager is a self-hosted, enterprise-ready solution for managing and distributing one-time passwords across your organization. Whether you're managing guest WiFi access, temporary credentials, event passes, or service vouchers, OTP Manager provides a secure, efficient, and user-friendly platform for OTP lifecycle management.

Screenshots

Mobile

Desktop

Features

• 📱 Progressive Web App - Installable on any platform (iOS, Android, Windows, macOS, Linux)
• 🌐 Centralized OTP Distribution - Single source of truth for all one-time passwords
• 👥 Multi-User Support - Manage OTP access across unlimited users and teams
• ✅ Real-time Status Tracking - Instant visibility into OTP usage and availability
• 🔒 Role-Based Access Control (RBAC) - Granular permissions for admins and regular users
• 📥 Smart Import System - Multiple import methods including plain text, PDF parsing, and bulk paste
• 🔌 Vendor Integrations - Native support for network equipment vendors (see supported vendors)
• 🔄 Extensible Parser Framework - Easy to add support for additional vendors and formats
• 📁 Bulk Operations - Import, delete, and mark multiple OTPs as used in one action
• 🔍 Search & Filter - Quickly find OTPs with advanced search and filtering capabilities

Quick Start

Container Deployment (Recommended)

Prerequisites

• Podman or Docker

Using Docker/Podman Compose

# Clone the repository
git clone https://github.com/gautamkrishnar/otpshare.git
cd otpshare

# Copy and configure environment
cp .env.example .env
# Edit .env with your configuration

# Start the application, this uses the pre-built Image
podman compose up -d
# or
docker compose up -d

The application will be available at http://localhost:{PORT-GIVEN-IN-ENV}

Default Credentials (First Run)

On first startup, you'll be prompted to create an admin account. No default credentials are set for security.

Local Development

For detailed development setup instructions, see the Development Setup Guide in the project wiki.

Documentation

📖 Visit the Wiki for complete documentation

Quick Links:

• Installation Guide - Deploy with Docker or from source
• Quick Import Guide - Import your first OTPs
• TP-Link Omada Integration - Import from Omada Controller
• Development Setup - Set up local environment
• Contributing Guide - How to contribute

Vendor Support & Integrations

OTP Manager supports multiple methods for importing one-time passwords, including native integrations with popular network equipment vendors.

Currently Supported

Network Equipment Vendors

• ✅ TP-Link Omada - Direct PDF voucher import from Omada Controller
  • Supports guest portal voucher exports
  • Automatic parsing and batch import
  • View Integration Guide →

Generic Import Methods

• ✅ Plain Text - Import from text files (one code per line)
• ✅ Manual Entry - Bulk paste codes into the admin interface

More vendors coming soon! Request an integration or view the roadmap.

Contributing

We welcome contributions! See the Contributing Guide for details on:

• Development setup and workflow
• Code style and quality standards
• Pull request process
• Adding vendor integrations

License

This project is licensed under the GNU Affero General Public License v3.0 - see the LICENSE file for details.

Powered by

Support & Community

• 🐛 Report Issues: GitHub Issues
• 💡 Feature Requests: GitHub Issues
• 💬 Discussions: GitHub Discussions
• ⭐ Star this project if you find it useful!

Made with ❤️ and TypeScript