Skip to content

Accounts and security

How do I turn on two-factor authentication?

Section titled “How do I turn on two-factor authentication?”

Add it under Settings → Account → Sign-in, for every account that can reach Maki from outside your network. See Reverse proxy and HTTPS.

Yes, once HTTPS works end to end. Put TLS in front of Maki, then turn on Require HTTPS under Settings → System → Network. Also list your reverse proxy under Trusted proxies, or Maki blames the proxy for every failed sign-in and rate limiting sees the wrong client. Restart Maki afterwards, because network settings apply at startup.

New accounts have no root folder access. Grant folders under Settings → Users & security → Users. The same grants decide where someone with Add series may add a title. See Users and library access.

Yes, with OpenID Connect alongside local passwords. Fill in Settings → Users & security → Single sign-on and restart Maki. The single sign-on guide covers the redirect URI and claim mapping. An account that signs in only through single sign-on has no password to confirm, so creating an API key or turning on OPDS asks for a sign-in from the last ten minutes instead.

Section titled “I lost an API key or OPDS link. Can I get it back?”

No. Both are shown once and Maki stores only a fingerprint. Create a new key under Settings → Account → API keys. Regenerating the OPDS token also signs KOReader out, so log it in again with the new token.

Why does sign-in give the same error for every failure?

Section titled “Why does sign-in give the same error for every failure?”

A wrong password, unknown username, disabled account and lockout all return the same 401, so the login page cannot reveal which accounts exist.