Password reset links
The instance sends no email, so a lost password is reset with a link. The owner or an admin makes the link on the Members page and sends it to the person. Anyone with access to the server can make one with a command, for any account, the owner’s too.
From the Members page
Section titled “From the Members page”- Open Members from the workspace menu, and choose the person.
- Under Password, select Reset link.
- Select Make the link.
- Select Copy the link, and send the link to the person by a private channel. The dialog shows it only one time.
Who can make a link:
- An admin makes links for members.
- The owner makes links for anyone else, admins too.
- Nobody makes a link for themselves or for the owner on the Members page. The owner uses the command below.
The link works one time, within 24 hours. Each person has one link at most: a new link replaces the old one.
Use the link
Section titled “Use the link”The person opens the link. The page “Set a new password” asks for the new password, at least 12 characters, and the same password again.
- Enter the new password in New password and Confirm password.
- Select Set password.
The instance sets the password, signs the person out on every device, and signs them in again in this browser. The old password works until the link is used.
If the person is already signed in to the instance in that browser, the page asks them to sign out first. A link that expired, was used, or was replaced gets the message “This reset link no longer works. Ask for a new one.”
When a link stops by itself
Section titled “When a link stops by itself”A link never outlives the right of the person who made it:
- A change to the person’s role or access cancels their pending link.
- A handover of ownership cancels the pending links of the old and the new owner.
- When an admin is removed, or becomes a member, the links that they made stop working.
- When the link is used, the instance checks again that its maker may still reset this person’s password.
From the server
Section titled “From the server”Run this in the instance’s folder, with the person’s email address:
docker compose exec api node dist/reset-password.mjs owner@example.comThe command prints a link for that account. It works for every account, the owner’s too.
- The link works one time, for one hour. It replaces an earlier link of the same account.
- If no account has the email address, the command says so and exits with status 1.
See Server commands.
Limits
Section titled “Limits”- Anyone who sees a link before it is used can use it. Send it by a private channel.
- Using a reset link is rate-limited for each client address: 10 requests at once, then one a minute.
- Password reset by email is not available yet.