2fauth
2FAuth is a self-hosted web app that stores your two-factor authentication (2FA) accounts and generates their time-based security codes.
Platform availability
Available on 5 of 10 platforms
- Unraid
- TrueNAS
- Umbrel (not listed)
- ZimaOS
- Proxmox
- Helm (not listed)
- Mac (not listed)
- Windows (not listed)
- Linux (not listed)
- Any server
Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.
85/100 Excellent
- Maintained
- 100last commit 19 days ago
- Popular
- 724,215 GitHub stars
- Easy to install
- 755 install platforms, install notes, Docker image
- Light to run
- 801 GB minimum RAM, runs on ARM
Availability: platform listings confirmed today, links checked 10 days ago
- GitHub stars
- 4,215
- Open issues
- 15
- Last commit
- 2026-11-02
- Latest release
- v9.0.1
- License
- AGPL-3.0
- Activity
- steady
Checked 17 days ago - source: GitHub (Bubka/2FAuth)
Resources & Compatibility
Minimum requirements: 1 GB RAM, 1 CPU core(s), 10 GB disk. ARM (e.g. Raspberry Pi) is supported.
Checked 54 days ago - source: Docker Hub image tags and published docs
First-install notes
- Start 2FAuth with Docker Compose If you use Docker Compose (a tool that starts a container from a config file), run docker-compose up in the folder with docker-compose.yml. This starts the 2FAuth container; without it, the app won't be running. source
- Self-hosted: make .env and run setup For a first self-hosted install, copy .env.example to .env in /var/www/2fauth, edit your private settings, and run the four Artisan commands: php artisan migrate:refresh, php artisan passport:install, php artisan storage:link, and php artisan config:cache. Artisan is the app's setup command line, and these steps prepare settings, database, and storage; skipping them can make 2FAuth fail or lose da source
- Set email settings for recovery emails If you want 'Recover your password,' set the MAIL_* values in your .env file, replacing the example host, port, username, password, and from address with your email provider's details. Without them, 2FAuth can still run but can't send a recovery email. source
- Unraid: prepare appdata folder Before starting the container on Unraid, run in the Unraid CLI (terminal): mkdir /mnt/user/appdata/2fauth, then chown 1000:1000 /mnt/user/appdata/2fauth, so the container can read and write its data. On first login, register the first username as the admin user. source
Fetched 37 days ago - each note links to its source
Variants
Alternatives
No alternatives collected yet.
Common questions
Can I use 2FAuth on a phone?
A community description says it has an interface for mobile and desktop.
Where are 2FAuth logs stored?
They are stored in the storage/logs subfolder of your installation folder.
What folder should I use when installing 2FAuth from source?
The self-hosted server guide uses /var/www/2fauth as the example location for the 2FAuth folder.
Can 2FAuth generate Steam Guard codes?
It supports TOTP, HOTP, and Steam Guard codes.
Answers sourced from docs.2fauth.app, docs.2fauth.app, www.reddit.com, www.xda-developers.com
Community
- Selfhosting 2fAuth : r/selfhosted - Reddit (reddit)
- Can we trust 2fauth ? : r/selfhosted - Reddit (reddit)
- 2Fauth. What's our thoughts? : r/selfhosted - Reddit (reddit)
- 2FAuth : r/ITProTuesday - Reddit (reddit)
- Hosted 2fa with android app recommendations : r/selfhosted - Reddit (reddit)
Collected 54 days ago - public community threads