Self-hosted password manager for secure online credentials.
Written in Python/Django

Features

• AES-256 GCM Encryption: Each user's data is encrypted using a unique encryption key derived from their master password and a user-specific salt, ensuring isolation between accounts.
• Multi-Factor Authentication: Protect your account with your favorite authenticator app.
• Password Generator Tool: Built-in tool to generate strong, random passwords, with customizable options (length, character types).
• Password Health Monitoring: Built-in tool to check the strength and health of stored passwords, identifying weak, reused, or compromised passwords.
• Import/Export Data: Upload data such as passwords from a CSV file or download your stored data in CSV format for easy backup or migration.
• Automatic Logout: Automatically logs you out after a customizable period of inactivity. Choose the timeout duration that best suits your needs.

Django Models

Purpose

The primary goal of this project is to provide a self-hostable, open-source password manager that anyone can use and learn from. While the app is available for use, my main intention is not to attract active users or compete with major applications like Bitwarden. Instead, I aim to offer a self-host option for those who prefer full control over their password management and to share the code, primarily written in Django, for educational or personal use.

If you find this project interesting, helpful, or inspiring, please consider giving a star, following, or even donating to support further development.

Setup for Local Development

Install uv

cd path/to/root/directory
pip install uv

Create Environment Variable file

touch main/.env
nano main/.env

Add the following (adjust as needed):

# Django settings
SECRET_KEY="example_secret_key"  # https://stackoverflow.com/a/57678930
ALLOWED_HOSTS="localhost,127.0.0.1"
CSRF_TRUSTED_ORIGINS="http://localhost:8001"
DEBUG=True  # For development

# OPTIONAL: PostgreSQL Configuration (remote production)
DATABASE_URL="postgres://[username]:[password]@[host]:[port]/[db_name]"

# Email settings
EMAIL_HOST_USER="example_email_host"
EMAIL_HOST_PASSWORD="example_email_password"

Save changes and close the file.

Note: You can deploy the application using Docker:
NGINX + Gunicorn + External DB

docker compose up

Migrate Database

uv run manage.py migrate

Run Django Server

uv run manage.py runserver

Access web application at http://127.0.0.1:8000 or http://localhost:8000.

Run Tests

uv run manage.py test

Demo Images

Contributing Guidelines

Pull Requests

• Simplicity: Keep changes focused and easy to review.
• Libraries: Avoid adding non-standard libraries unless discussed via an issue.
• Testing: Ensure code runs error-free, passes all tests, and meets coding standards.

Bug Reports

• Report bugs via GitHub Issues.
• Submit pull requests via GitHub Pull Requests.

Thank you for supporting PassManager!