Skip to content

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.

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.

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.

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.

From the folder with your hub’s compose.yml (for example /opt/takt), run:

Terminal window
docker compose exec hub node dist/cli.js reset-password you@example.com

It 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.

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-2fa to the command.

Turn two-factor back on in Settings → Security once you’ve logged in.

  • 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.
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.