# Your Frameleaf account

Source: https://frameleaf.app/docs/cloud/account/

Your Frameleaf account connects your server to Frameleaf Cloud. Link it once and you get one sign-in for you and your family, plus remote access, backup and the other services in your plan. Prefer to stay fully local? A local photo account works without linking.

You'll meet three accounts: the Manager administrator runs the installation, your local photo account lives on your server, and your Frameleaf account connects Cloud services.

## Sign in

Sign in from the link on your server, at the [Frameleaf account site](https://frameleaf.cloud/) or in the Frameleaf apps. Add a second recovery method in your account settings so you can always get back in.

### Create an account

An account is free. Choose **Create an account** on the sign-in page, enter your email and your country or region, and accept the terms. Frameleaf emails you a 6-digit code to confirm the address, and offers to create a passkey, which signs you in with your face, fingerprint or device PIN. There's no password to remember; you can add one later if you want one. The [phone apps](https://frameleaf.app/docs/apps/iphone/#get-started) create an account the same way, on the same screen you sign in on.

### How signing in works

A passkey signs you in by itself. Otherwise signing in takes two steps:

- **With your password** (a password is optional; add one under **Sign-in and security**), the second step is a code from your authenticator app or one of your recovery codes. If you don't use an authenticator app, Frameleaf emails you a 6-digit code instead; enter it to finish, or choose **Send a new code**.
- **With an emailed code**, that's enough only while your account has no passkey and no authenticator app. Otherwise Frameleaf asks for one more thing: your authenticator code, a recovery code or your password, or you can sign in with your passkey instead. **Can't use any of these? Recover your account** starts recovery.

Wrong codes are counted together across every step: after five in 15 minutes, Frameleaf stops checking codes for a while. Try again later.

### Sign-in and security

**Sign-in and security** on the account site shows how you sign in and what happened on your account recently. Under **Sign-in methods** you can:

- **Add a passkey**, and a second one on another device so losing one never locks you out.
- **Set up an authenticator app**: scan the QR code with an app such as 1Password or Google Authenticator, then enter the 6-digit code it shows. From then on you need a code from the app whenever you sign in with a password.
- **Add password**, **Change password** or **Remove password**. A password is optional and needs at least 8 characters.

**Activity** lists recent security events, such as sign-ins and changes to your passkeys. If you see something you don't recognise, choose **Sign out other sessions** and change how you sign in.

This is separate from [two-step sign-in](https://frameleaf.app/docs/using/two-step-sign-in/) on your server, which protects the password of your photo account there.

### Recovery codes

Any account with a passkey or an authenticator app can have recovery codes. Open **Sign-in and security** on the account site, and under **Recovery codes** select **Make a new set**. Each code works once, in place of your passkey or authenticator app. Save them straight away: they're shown only once, and a new set replaces the old one.

### Lost your passkey?

Choose **Lost your passkey?** on the sign-in page. Frameleaf emails you a code, then checks one more thing only you should have: a code from your authenticator app, one of your recovery codes, or the number of a card saved on your account (nothing is charged). After that you create a new passkey, the lost ones stop working, and the account's other devices, apps and servers are signed out.

If you can't do any of those, you can wait instead. Frameleaf emails your address when the wait starts and again the day before it ends, and then you sign in with a new email code to create your passkey. Signing in with one of the current passkeys cancels the recovery, so someone who only has your email can't take the account over quietly.

### Confirm it's you

For sensitive changes, Frameleaf may ask you to confirm it's you. Check the server, account and action shown, then approve. It asks for the strongest thing your account has: your passkey (**Use my passkey**), otherwise your authenticator app (**Use my authenticator app**), otherwise a code emailed to you (**Email me a code**). A confirmation stays valid for 10 minutes.

## Link a server

You need to be an administrator of the photo server, and Cloud needs to be configured for your release or deployment.

[![The server’s Account & link page: This server isn’t linked to a Frameleaf account with a Link this server button, then What linking leads to, listing the Frameleaf apps finding the server, Remote access, Cloud Backup and Cloud processing with what each needs.](https://frameleaf.app/shots/docs/cloud-account-link-2026-11.jpg)](https://frameleaf.app/shots/docs/cloud-account-link-2026-11.jpg)

*Start linking from the photo server's **Account & link** page. Linking doesn't upload your library; you turn on each Cloud service separately. Select the image to enlarge it.*

1. Open **Settings**, then **Frameleaf Cloud**, then **Account & link**.
2. Choose **Link to Frameleaf**.
3. Open the link or scan the QR code, then sign in.
4. Check that the approval code and server details match the ones on your server.
5. Approve the link.

If the code expires or the link is declined, start again with a new code. If the server is already linked or your account has reached its server limit, the page tells you; sort that out and try again.

To see exactly what your server shares, open **What this server sends** and the permission controls on **Account & link**.

### Link a server with no browser

A server with no screen or browser to hand can link with a single-use link token:

1. On the account site, open **Servers**, choose **Link a server**, then **Create a link token**. Note when it expires.
2. Set it as `FRAMELEAF_LINK_TOKEN` in the server environment.
3. Start the server.
4. Once it's linked, remove the token from the environment.

Keep tokens private.

## Sign in with Frameleaf on your server

Each person links their own account from **Settings**, then **Your preferences**, then **Frameleaf account**. Everyone keeps a private library: linking a server doesn't give its owner access to other people's photos. Share albums, items or [shared spaces](https://frameleaf.app/docs/using/albums/#shared-spaces) when you want others to see them.

Local passwords and your own OAuth sign-in keep working alongside it. Remote access has its own sign-in rules; see [Who can sign in](https://frameleaf.app/docs/cloud/remote-access/#who-can-sign-in).

## Share a server with people

Invite family and friends from the server's **Sharing** page on the account site. Under **Invite someone**, enter their email, choose a role and select **Send invitation**. They get an email with a link and accept with their own Frameleaf account.

| Role | What they can do |
| --- | --- |
| **Viewer** | Sees shared albums and the timeline; can't upload or edit |
| **Editor** | Uploads, edits and organises photos; no server settings |
| **Admin** | Everything an editor can do, plus server settings and sharing |

A change of role takes effect the next time they sign in; **Remove** signs them out straight away. To share photos with them, use the library's sharing controls.

New invited accounts start with the **Space for new people** that administrators set under **Settings → Users**. See [Space for new people](https://frameleaf.app/docs/admin/users/#space-for-new-people).

## Keep the server identity safe

Your server's identity is stored with the installation. Keep it, together with the Manager recovery configuration, in your private recovery plan. Run each linked identity on one server only.

See [Environment variables](https://frameleaf.app/docs/admin/environment-variables/#frameleaf-cloud) for manual deployment settings.

## Licences, plans and credit

Activate a supporter licence on the linked server before you buy a Cloud plan or AI credit. A licence is paid once and lasts for life.

- **Supporter badge:** a Server licence gives one to every account on the server; an Individual licence to your own account.
- **Cloud Backup:** needs a Cloud plan as well as the licence. A Server licence covers every account on the server; an Individual licence covers only your own account.
- **Buddy pairing:** Both servers need a Server licence to start a new Buddy Backup pairing. A Frameleaf Cloud plan is needed only when the servers can't connect directly and use the relay. An Individual licence doesn't create pairings.
- **AI processing:** needs a licence on the server sending the job. No Cloud plan needed.

A Server licence gives your linked server its Frameleaf direct address. Connections through Frameleaf, your server's name on frameleaf.net, the Frameleaf apps away from home and backup storage come with the Cloud plan. Without a licence, your local library keeps working.

A Server licence takes 7% off the standard Cloud plan and an Individual licence takes 5% off. They don't stack: with both, 7% applies. Extra backup storage, AI credit and GPU charges aren't discounted.

If a licence ends, a later invoice may lose its discount and new backup writes or processing pause. Your stored backups stay put and earlier wallet charges are unchanged. Cancelling a plan has its own retention rules, shown in your account notice.

See [Plans and supporter licences](https://frameleaf.app/docs/cloud/overview/#plans-and-supporter-licences) and [Cloud GPU payment](https://frameleaf.app/docs/cloud/cloud-gpu/#how-you-pay).

## Unlink a server

Unlink from **Account & link** on the server or from the server controls on the account site. Unlinking stops remote access, linked sign-in, new Cloud processing and scheduled Cloud backups.

Before you unlink, make sure you have a local administrator login and your recovery copies. The confirmation screen shows what happens to your backups and billing.

## Close or delete your account

To delete your Frameleaf account, or close it without erasing it, see [Delete your account](https://frameleaf.app/docs/cloud/delete-account/). Export any information and recover any backups you need first. Neither touches the files on your server.
