Forgotten passwords
Your hub doesn’t send email, and takt can’t reset your password for you. Instead, someone with the right to do it creates a one-time reset link.
If you’re a member
Section titled “If you’re a member”Ask your hub’s owner or an admin for a reset link. They’ll find you on the Team page, choose Reset password, and send you the link.
Open it, choose a new password, then log in as normal. If two-factor is on for your account, you’ll still need your code.
The link works once, for one hour. If it’s expired, ask for a new one.
If you’re the owner
Section titled “If you’re the owner”Nobody in the app can reset the owner’s password. You reset it on the machine your hub runs on: whoever controls that machine already controls the hub.
Using the desktop app
Section titled “Using the desktop app”In the menu bar, choose Hubs → Reset Password on This Computer…. Your hub’s window opens on the reset page. Choose a new password and log in.
On a server
Section titled “On a server”From the folder with your hub’s compose.yml (for example /opt/takt), run:
docker compose exec hub node dist/cli.js reset-password you@example.comIt prints a link. Open it within 15 minutes, choose a new password and log in. Use --owner instead of your email if you’ve forgotten which address you used.
Lost your authenticator as well?
Section titled “Lost your authenticator as well?”If two-factor is on and you’ve lost your authenticator app, log in with one of your backup codes first.
If you’ve lost those too, the reset can turn off two-factor at the same time:
- A member: ask the owner or an admin to tick Also turn off two-factor when they make your link.
- The owner, using the desktop app: choose Turn It Off when it asks.
- The owner, on a server: add
--disable-2fato the command.
Turn two-factor back on in Settings → Security once you’ve logged in.
What happens when a password is reset
Section titled “What happens when a password is reset”- The account is signed out everywhere, so anyone using the old password is locked out.
- The owner and admins are notified. A reset made on the server is flagged clearly, so it’s never a surprise.
- It’s recorded in the activity log.
- Each link works once, and making a new one cancels the old one.
Why there’s no “email me a reset link”
Section titled “Why there’s no “email me a reset link””Most apps send reset links by email, through the company that runs them. With takt, that would mean anyone who got into your takt account, or into takt itself, could take over your hub and your broker connections.
Resetting on your own machine keeps your hub yours: only you and the people you’ve made admins can ever get into it.