Users
One library for the whole family Watch on YouTube
Share one server with your whole family or team, and give everyone their own private library. As an administrator you manage accounts in the Command Center: select Settings in the sidebar, then open Users.
The list shows each account’s role (Member or Administrator), status, number of items and Storage used / limit. You can search by name or email, filter to Active, All, Deleted or Administrators accounts, and sort by name, newest first or storage used. Select an account to open its details under the list.
The first administrator
Section titled “The first administrator”A new server has no accounts. The first person to set it up from the home network becomes the administrator, on its web page or in the Frameleaf app. There is no setup code. See Setting up a new server.
Add a person
Section titled “Add a person”- In Users, select Add a person.
- Enter their Name and Email.
- Choose their Role: Member or Administrator.
- Choose their Space for this person: No limit, 50 GB, 200 GB, 500 GB, 1 TB, or Other… for an exact amount in GB. It starts from Space for new people (see below).
- Choose How they first sign in:
- Email them a link: they choose their own password, and you never see it. The link works once, for 7 days. This only appears once email is set up, and is then the default.
- A temporary password: Frameleaf makes one up and shows it to you once, to pass on. They must change it the first time they sign in. Turn on Email them their sign-in details to send it with the server’s address; this also needs email.
- Your sign-in provider: they sign in with your sign-in provider using this email, with no password. This only appears once a provider is set up.
- Optionally, pick a colour, and under Advanced set a Folder name on disk (see below).
- Select Add person.
Space for new people
Section titled “Space for new people”Space for new people, under the list, is the space every new account starts with, however it’s made: added here, invited through Frameleaf, or created by your sign-in provider. You can change anyone’s space afterwards.
Invite people with their Frameleaf account
Section titled “Invite people with their Frameleaf account”When your server is linked to Frameleaf Cloud, you can invite people from your Frameleaf account instead of creating a password for them. An invited person gets their own account and library the first time they use Sign in with Frameleaf, on the web or in the Frameleaf app. Being invited doesn’t show them your library; share items, albums or Spaces with them for that.
New invited accounts start with Space for new people. It’s No limit by default, so their phone can back up straight away.
When you or Frameleaf Cloud remove someone’s access, their Frameleaf sign-ins on your server end. Their account and library stay until you delete the account.
See Share a server with people.
Change someone’s details
Section titled “Change someone’s details”An account’s details open under the list. Under About, change their name, email, role or Space for this person, or turn on Pause new uploads, then select Save (or Undo).
To keep you from locking yourself out, you can’t remove your own account or change your own role while you’re signed in with it.
Storage quotas
Section titled “Storage quotas”Space for this person limits how much they can upload. Once they reach it, new uploads stop; their existing photos stay.
- No limit lets them add until the server is full.
- Pause new uploads stops new uploads while they keep their photos and can still look at them. Turn it off to let them add again.
- A limit doesn’t reserve disk space, so you can set limits that add up to more than your disk holds.
- A photo that two people both have counts towards each person’s space, though it’s stored once.
- Photos in folders of photos added from your server or NAS don’t count towards it.
Storage labels
Section titled “Storage labels”By default Frameleaf chooses the folder each person’s files are stored in. Under Advanced, Folder name on disk replaces that with a name you choose, using letters, numbers, hyphens or underscores. It’s used by the storage template.
Changing it doesn’t move files that are already stored. They move the next time Frameleaf tidies its folders, when you run the Sort originals into folders job.
Turn off casting
Section titled “Turn off casting”Allow casting controls whether the account can use Google Cast. It’s one of their own choices: under What they’ve turned on, select Change for them…. When it’s off, the person can’t turn casting back on themselves.
Sign-in and security
Section titled “Sign-in and security”Reset a password
Section titled “Reset a password”- Open the account and select Reset password.
- Select Generate temporary password.
- Select Copy password and give it to them, then Done. It’s shown only once.
Their old password stops working, and they must choose a new one when they next sign in. Their passkeys are removed too, so only the new password gets in.
Once email is set up, you can select Email a link… instead. They choose a new password themselves, and their current one keeps working until they do.
Reset or set a Locked PIN
Section titled “Reset or set a Locked PIN”Under Locked PIN:
- Set PIN (when they have no PIN yet) or Change PIN (when they have one) sets a six-digit PIN for them.
- Reset PIN clears the person’s PIN so they can set a new one after signing in.
- While the person has Locked encryption turned on, you can’t change or reset their PIN; doing so would leave their files unopenable. They reset it with their recovery key.
Either way, every device signed in to the account is signed out of Locked content. Their protected photos stay protected.
Two-step sign-in
Section titled “Two-step sign-in”The Two-step sign-in row on the person’s page says whether they use two-step sign-in. Only they can turn it on, in their own sign-in settings.
If they’ve lost their phone and their recovery codes:
- Make sure it’s really them asking, for example in person or on a call you made. Anyone else could use this to get past their phone.
- Select Turn off two-step sign-in…, then Turn off.
They sign in with their password alone until they turn it on again. Their recovery codes stop working, browsers they trusted forget it, and they’re signed out on every device. It’s noted in their account history, with your name.
Passkeys
Section titled “Passkeys”The Passkeys row says how many passkeys the person has. Only they can add one, in their own sign-in settings, and they remove a single passkey there too.
If they’ve lost a device and can’t sign in to remove its passkey:
- Select Remove all passkeys….
- The confirmation says what happens. You can’t remove just one. Select Remove all.
Every passkey stops working straight away, on every device, and the devices they signed in with a passkey are signed out. They sign in with their password and can add new passkeys. It’s noted in their account history, with your name.
Signed-in devices
Section titled “Signed-in devices”Signed-in devices lists the devices signed in to the account, with when each was last seen. Select Sign out to sign a device out; it needs to sign in again to see the library.
See one person’s activity
Section titled “See one person’s activity”On the person’s page, under Sign-in & security, All of their name**’s activity** opens the Activity log showing only them.
Sign-in provider
Section titled “Sign-in provider”If the account is connected to your OAuth provider, its details show Connected. Accounts set to Sign-in provider only have no password.
Activity log
Section titled “Activity log”The Activity log shows what has happened on everyone’s accounts, in one list. Use it to answer questions such as “who signed in last night?”, “did someone really reset that password?” or “which app has been using Sam’s library?”. It shows what happened to each account, never anyone’s photos.
To open it, go to Settings, then Users, and under What’s been happening select Open Activity log. The row says when the latest activity was. Only administrators see this page. Each person sees their own part of the list in their account activity.
The list is newest first and grouped by day. Each row is a plain sentence, such as “Sam signed in on an iPhone, at home”, with the time and the picture of whoever did it. It covers:
| Kind | Examples |
|---|---|
| Sign-ins | Signing in and out, with how (password, passkey, two-step code, Frameleaf account or your sign-in provider), the device, and whether it was at home or away. A try that failed is marked Didn’t get in |
| Security | A password or Locked PIN changed, two-step sign-in turned on or off, a passkey added or removed, a device signed out, an API key made or removed |
| Sharing | A sharing link made or removed, photos shared with someone, a library shared with a partner |
| Apps | A connected app connected, disconnected, refused or used. An app Frameleaf disconnected for safety is marked Cut off |
| What administrators did | An account created, a name or email changed, a password or PIN reset, two-step sign-in or passkeys removed, someone made an administrator or a member again, a space limit changed. These rows name the administrator |
To narrow the list:
- Whose shows one person, or Everyone.
- The Show chips pick a kind: All, Sign-ins, Security, Sharing or Apps.
- Show earlier activity loads further back. It also loads by itself as you reach the end.
When signing in didn’t work for someone in the last day, the page says so at the top, with how many times and where the latest try came from. None of those tries got in. Ask the person if it was them. If not, select Open and their name on the row, and reset their password from their page.
Activity is kept for 400 days, then removed.
Delete an account
Section titled “Delete an account”- Open the account and select Remove this person.
- Under Type the account email to confirm, enter their email.
Deleting signs out the account’s devices and starts a recovery period, 7 days by default. During that time the account shows as Deleted and its files stay on the server. Select Restore account to bring it back; devices that were signed out need to sign in again.
After the recovery period the account, its originals and its library entries are removed permanently, along with its Locked encryption key file if it has one. Accounts are removed by the Empty Trash and tidy up step of the overnight schedule, which starts at midnight by default, while its Empty Trash and remove deleted accounts choice is on. Change the length in Settings, then Storage & originals, then Deleted items, with Keep a deleted account for. Changes apply from the job’s next run.
Reset the administrator password
Section titled “Reset the administrator password”If you’re locked out of the only administrator account, reset its password from the server:
docker exec frameleaf_server frameleaf-admin reset-admin-passwordYou’re asked for a new password (leave it empty to generate one) and whether to sign out existing sessions. The same tool can list users, and grant or revoke administrator rights. The last two ask for the person’s email:
docker exec frameleaf_server frameleaf-admin list-usersdocker exec frameleaf_server frameleaf-admin grant-admindocker exec frameleaf_server frameleaf-admin revoke-adminSee Server commands for the rest.
See how much space people use
Section titled “See how much space people use”Library analytics in the Command Center shows storage used across accounts, and each account has a View analytics link. See Command Center.
© 2026 Frameleaf Inc. All rights reserved.
Frameleaf and the Frameleaf logo are Trademarks of Frameleaf Inc.



