Hanko is an authentication and user management server. It provides passkeys, passwords, email passcodes, multi-factor authentication, OAuth and SAML single sign-on, sessions and JWT issuing through a public API, plus an admin API for user management. Pair it with the Hanko Elements web components or your own frontend.
Hanko stores its data in an external PostgreSQL, MySQL, MariaDB or CockroachDB database; no database is bundled.
Examples
sudo hanko migrate up
sudo hanko serve all
sudo hanko user import users.json
sudo hanko config show
hanko version
The commands read /var/snap/hanko/common/config.yaml, which holds the generated encryption key and is readable by root only. Use --config to pick another file.
Background service
The service is installed disabled. It applies database migrations and runs the public API on 127.0.0.1:8000 and the admin API on 127.0.0.1:8001. Point it at a database and start it:
sudo snap set hanko database-url='postgres://hanko:secret@db.example.com:5432/hanko?sslmode=require'
sudo snap start --enable hanko.daemon
WebAuthn origins, CORS, SMTP and the other settings are in /var/snap/hanko/common/config.yaml; restart the service after editing:
sudo snap restart hanko.daemon
The admin and optional multi-tenant management APIs have no authentication. Keep them on localhost or behind an access-controlled proxy.
Thank you for your report. Information you provided will help us investigate further.
There was an error while sending your report. Please try again later.
Snaps are applications packaged with all their dependencies to run on all popular Linux distributions from a single build. They update automatically and roll back gracefully.
Snaps are discoverable and installable from the Snap Store, an app store with an audience of millions.
Snap is available for Red Hat Enterprise Linux (RHEL) 8 and RHEL 7, from the 7.6 release onward.
The packages for RHEL 7, RHEL 8, and RHEL 9 are in each distribution’s respective Extra Packages for Enterprise Linux (EPEL) repository. The instructions for adding this repository diverge slightly between RHEL 7, RHEL 8 and RHEL 9, which is why they’re listed separately below.
The EPEL repository can be added to RHEL 9 with the following command:
sudo dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm
sudo dnf upgrade
The EPEL repository can be added to RHEL 8 with the following command:
sudo dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm
sudo dnf upgrade
The EPEL repository can be added to RHEL 7 with the following command:
sudo rpm -ivh https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm
Adding the optional and extras repositories is also recommended:
sudo subscription-manager repos --enable "rhel-*-optional-rpms" --enable "rhel-*-extras-rpms"
sudo yum update
Snap can now be installed as follows:
sudo yum install snapd
Once installed, the systemd unit that manages the main snap communication socket needs to be enabled:
sudo systemctl enable --now snapd.socket
To enable classic snap support, enter the following to create a symbolic link between /var/lib/snapd/snap and /snap:
sudo ln -s /var/lib/snapd/snap /snap
Either log out and back in again or restart your system to ensure snap’s paths are updated correctly.
To install Hanko, simply use the following command:
sudo snap install hanko --beta
Browse and find snaps from the convenience of your desktop using the snap store snap.
Interested to find out more about snaps? Want to publish your own application? Visit snapcraft.io now.