# Users

Source: https://frameleaf.app/docs/admin/users/

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

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](https://frameleaf.app/docs/admin/system-settings/#setting-up-a-new-server).

## Add a person

1. In **Users**, select **Add a person**.
2. Enter their **Name** and **Email**.
3. Choose their **Role**: **Member** or **Administrator**.
4. 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).
5. 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](https://frameleaf.app/docs/admin/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](https://frameleaf.app/docs/admin/sign-in-and-oauth/) using this email, with no password. This only appears once a provider is set up.
6. Optionally, pick a colour, and under **Advanced** set a **Folder name on disk** (see below).
7. Select **Add person**.

### 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

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](#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](https://frameleaf.app/docs/cloud/account/#share-a-server-with-people).

## 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

**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](https://frameleaf.app/docs/admin/external-libraries/) added from your server or NAS don't count towards it.

### 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](https://frameleaf.app/docs/admin/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

**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

### Reset a password

1. Open the account and select **Reset password**.
2. Select **Generate temporary password**.
3. 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](https://frameleaf.app/docs/using/account-settings/#passkeys) are removed too, so only the new password gets in.

Once [email](https://frameleaf.app/docs/admin/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

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](https://frameleaf.app/docs/using/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

The **Two-step sign-in** row on the person's page says whether they use [two-step sign-in](https://frameleaf.app/docs/using/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:

1. 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.
2. 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

The **Passkeys** row says how many [passkeys](https://frameleaf.app/docs/using/account-settings/#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:

1. Select **Remove all passkeys…**.
2. 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

**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

On the person's page, under **Sign-in & security**, **All of** their name**’s activity** opens the [Activity log](#activity-log) showing only them.

### Sign-in provider

If the account is connected to your [OAuth provider](https://frameleaf.app/docs/admin/sign-in-and-oauth/), its details show **Connected**. Accounts set to **Sign-in provider only** have no password.

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

[![The Activity log for administrators: Everyone’s account activity, in one list, with chips for All, Sign-ins, Security, Sharing and Apps, a Whose menu set to Everyone, and a dated list naming who signed in and who made sharing links.](https://frameleaf.app/shots/docs/activity-log-2026-11.jpg)](https://frameleaf.app/shots/docs/activity-log-2026-11.jpg)

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](https://frameleaf.app/docs/using/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](https://frameleaf.app/docs/admin/connected-apps/) 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](#reset-a-password) from their page.

Activity is kept for 400 days, then removed.

## Delete an account

1. Open the account and select **Remove this person**.
2. 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](https://frameleaf.app/docs/using/locked-encryption/) key file if it has one. Accounts are removed by the **Empty Trash and tidy up** step of the [overnight schedule](https://frameleaf.app/docs/admin/jobs/#nightly-tasks), 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.

:::danger[Delete straight away]
**Skip recovery and permanently remove this account** deletes the account, its original photos and videos and its library entries at once. This can't be undone, and the files can't be recovered.
:::

## Reset the administrator password

If you're locked out of the only administrator account, reset its password from the server:

```bash
docker exec frameleaf_server frameleaf-admin reset-admin-password
```

You'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:

```bash
docker exec frameleaf_server frameleaf-admin list-users
docker exec frameleaf_server frameleaf-admin grant-admin
docker exec frameleaf_server frameleaf-admin revoke-admin
```

See [Server commands](https://frameleaf.app/docs/admin/server-commands/) for the rest.

## 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](https://frameleaf.app/docs/admin/command-center/#library-analytics).
