# Keeyo

Keeyo is a self-hosted inventory for your hardware security keys - track which key holds which passkey, 2FA registration and TOTP. It is open source and self-hosted, installable on TrueNAS.

Canonical page: https://ourlocalhost.com/app/4385/keeyo

## Description

Keeyo is a self-hosted inventory for your hardware security keys - track which key holds which passkey, 2FA registration and TOTP.

## Platform availability

Available on 1 of 10 platforms: TrueNAS.

## Health score

49/100 (Fair), based on 4 of 4 factors.
- Maintained: 83 (last commit 35 days ago)
- Popular: 14 (4 GitHub stars)
- Easy to install: 25 (1 install platform, install notes)
- Light to run: 50 (2 GB minimum RAM)

## Links

- GitHub: https://github.com/ans-ib/keeyo
- Documentation: https://ans-ib.github.io/keeyo/install.html
- TrueNAS: https://apps.truenas.com/catalog/keeyo/
- Official website: https://ans-ib.github.io/keeyo/

## Common questions

### Which port does Keeyo use?

Keeyo listens on port 5390 by default, which can be changed with the PORT environment variable.

### What do I need to back up?

All data lives in a single SQLite file under DATA_DIR, which defaults to /data. Back up that volume or directory.

### How do I run Keeyo behind a reverse proxy?

Set TRUST_PROXY=1 only when running behind a reverse proxy so X-Forwarded-* headers are honored.

### How do I enable OIDC single sign-on?

Set KEEYO_OIDC_ISSUER, KEEYO_OIDC_CLIENT_ID, and KEEYO_OIDC_CLIENT_SECRET to enable SSO. On a fresh instance, set KEEYO_OIDC_ADMIN_BOOTSTRAP=1 so the first SSO sign-in becomes admin and password setup is refused.

### How can I block Keeyo from making outbound requests?

Set KEEYO_OFFLINE=1 to block all outbound requests, which turns off FIDO device registry updates.

---
Source: Our Local Host (https://ourlocalhost.com/app/4385/keeyo), the self-hosted and open-source app directory.
