A local Auth0 clone for development and testing. AuthMan provides a complete authentication and authorization solution with a familiar API, perfect for local development, testing, and self-hosted deployments.
- Multi-tenant architecture - Manage multiple applications and environments
- Complete user management - Registration, authentication, profiles, and metadata
- Application management - Support for SPAs, web apps, native apps, and M2M
- Role-based access control (RBAC) - Fine-grained permissions and roles
- After-action scripts - Custom JavaScript hooks for authentication events
- Email templates - Customizable authentication emails with SMTP4Dev testing
- Vue 3 dashboard - Web-based management interface similar to Auth0
- SQLite database - Lightweight, file-based persistence
- Docker ready - Complete multi-service containerized deployment
- Email testing - Built-in SMTP4Dev for email development and testing
# Start all services (API + UI + Email Testing)
docker compose up -d
# Check service status
docker compose ps
# View logs
docker compose logs -fAccess Points:
- Dashboard: http://localhost:8080 - Vue 3 management interface
- API: http://localhost:3001 - REST API endpoints
- Email Testing: http://localhost:8025 - SMTP4Dev web interface
- Health Check: http://localhost:3001/api/tenants
# Build and run API container only
docker build -t authman:latest .
docker run -d --name authman \
-p 3001:3001 \
-e JWT_SECRET="your-jwt-secret" \
-e SESSION_SECRET="your-session-secret" \
-v $(pwd)/data:/app/data \
authman:latest# Start API server
npm install
node api/index.js
# Start UI dashboard (in another terminal)
cd ui && npm install && npm run devAccess the dashboard at http://localhost:5173 and API at http://localhost:3001
- Getting Started - Installation, setup, and basic configuration
- UI Dashboard Setup - Complete guide to the management dashboard
- API Integration - Integration examples for React, Vue, vanilla JS
- Deployment Guide - Docker deployment and production setup
- API Reference - Complete endpoint documentation
- Troubleshooting - Common issues and solutions
- Dashboard: http://localhost:8080 (Docker) / http://localhost:5173 (Local Dev)
- API: http://localhost:3001
- Email Testing: http://localhost:8025 (Docker only)
- Health Check: http://localhost:3001/api/tenants
AuthMan follows the Auth0 API patterns and provides compatible endpoints for easy migration:
┌─────────────────┐ ┌──────────────────┐ ┌─────────────────┐
│ Vue 3 UI │ │ Express API │ │ SMTP4Dev │
│ (nginx:8080) │◄──►│ (node:3001) │◄──►│ (smtp:8025) │
└─────────────────┘ └──────────────────┘ └─────────────────┘
│
▼
┌──────────────────┐
│ SQLite DB │
│ ./data/ │
└──────────────────┘
┌─────────────────┐ ┌──────────────────┐ ┌─────────────────┐
│ Vue 3 UI │ │ Express API │ │ SQLite DB │
│ (Vite:5173) │◄──►│ (node:3001) │◄──►│ (File-based) │
└─────────────────┘ └──────────────────┘ └─────────────────┘
- Single Page Applications (SPA) - React, Vue, Angular
- Regular Web Applications - Server-side rendered apps
- Native Applications - Mobile and desktop apps
- Machine to Machine - API-to-API authentication
AuthMan includes comprehensive email functionality for authentication workflows:
- Template System - Customizable email templates with variable substitution
- SMTP4Dev Integration - Built-in email testing server for development
- Email Logging - Track all sent emails with status and metadata
- Template Types - Welcome, password reset, email verification, and custom templates
# Test SMTP connection
curl http://localhost:3001/api/email/test-connection
# Send test email
curl -X POST http://localhost:3001/api/email/test \
-H "Content-Type: application/json" \
-d '{"to":"test@example.com","subject":"Test","body":"Hello World"}'
# Send template email
curl -X POST http://localhost:3001/api/email/send-template \
-H "Content-Type: application/json" \
-d '{"to":"user@example.com","templateType":"welcome_email","templateData":{"user":{"given_name":"John"},"application":{"name":"MyApp"}}}'
# View email logs
curl http://localhost:3001/api/email/logsAll emails are captured by SMTP4Dev and viewable at http://localhost:8025
AuthMan is an open-source project. Contributions are welcome!
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
This project is licensed under the MIT License - see the LICENSE file for details.
- 📖 Documentation: Check the docs folder for comprehensive guides
- 🐛 Issues: Report bugs or request features on GitHub Issues
- 💬 Discussions: Join the community discussions for questions and ideas
AuthMan - Making authentication simple for developers. ⚡