# A second Immich account

Markdown version of <https://sam-dumont.github.io/immich-memories/docs/run/multi-account/>.

Combine people pictures from two Immich accounts in one film. The app reads only your primary
account until you connect a second one and select both when making a people film. Films still
upload to the primary only.

## What you need

- An API key from the second account with the [ten read permissions](https://sam-dumont.github.io/immich-memories/docs/run/docker.md#the-api-key), shared with you by its owner. It needs no upload or delete rights.
- Named faces, connected through native identities or explicit account bindings.
- Your primary account already connected and [family set up](https://sam-dumont.github.io/immich-memories/docs/get-started/who-is-who.md).

The examples call the second account `partner`; it can belong to any household member, and the
label sets no relationship. Extra accounts live in YAML or environment variables (Settings shows
the primary connection only), and can be on another Immich server.

## The steps

Connect the account, bind matching people once, then make a film with both accounts selected.
The setup does not reset or re-tag faces in Immich.

## Connect the account

Add the second account alongside your primary connection:

```yaml
immich:
  url: "https://photos.example.com"
  api_key: "${IMMICH_API_KEY}"
  accounts:
    partner:
      url: "https://photos.example.com"
      api_key: "${PARTNER_IMMICH_API_KEY}"
```

For Docker, put the second account's key in `.env` and add this to the service's `environment:` block:

```yaml
      IMMICH_MEMORIES_IMMICH__ACCOUNTS__PARTNER__URL: "${IMMICH_URL:-http://immich-server:2283}"
      IMMICH_MEMORIES_IMMICH__ACCOUNTS__PARTNER__API_KEY: "${PARTNER_IMMICH_API_KEY}"
```

Recreate with `docker compose up -d`. A line in `.env` alone does not reach the container.
Test the connection:

```bash
immich-memories config test
```

In Docker, prefix commands with `docker compose exec immich-memories`.
The output identifies the owner of each key:

```text
✓ Connected as Kit: Server: https://photos.example.com; API: v3
✓ Immich account partner: Connected as Pat: API: v3
```

The `partner` line must identify the second account’s owner. If it names you, ask that owner to create a key from their account.
Configuring the account alone does not change a film's source scope.

## Native person identities

Native identities are optional. They keep both owner keys and the same library merge, because Immich hides a partner's favourite flag from the recipient, and timeline settings change
which partner assets appear in search. Owner reads keep both signals complete.

```yaml
immich:
  native_sharing: true
```

Add this field to the connection block above, then run `immich-memories preflight`.
The default is `false`, which keeps existing bindings and makes no native discovery requests.

| Server | Native mode |
| - | - |
| Immich 2.x or 3.0–3.1 | Existing bindings, with an unsupported-feature explanation |
| Immich 3.2.x | Shared recognition IDs within a cluster group; tested on 3.2.4 |
| Immich 3.3 | People-access discovery, tested on 3.3.3; 3.3.0-rc.1 and later 3.3.0 candidates are also accepted |
| Unknown major, newer minor, 3.3.0-rc.0 or a release candidate of any other version | Refused until compatibility is checked |

`api_version: v3` does not enable newer endpoints.
Each selected connection reports its actual version. The 3.2 path never calls `/people/users`.

The selected accounts on each server must belong to the same Immich cluster group.
For 3.3, share the requested people in Immich too; the `read` role is sufficient.
Discovery uses `user.read` and `person.read`, already in the ten read permissions above.
People grants and asset grants are separate. The app does not change either, regenerate
face clusters or enable partner timelines.

A proven shared ID needs only one local binding. This also works with `--accounts partner`:
a saved primary binding is reused when the partner proves that ID on the same server.
The cross-account People page shows that ID as linked without changing the saved registry.
Native automation counts each selected account's own pictures, so a partner-visible copy
of the same asset is counted once.
Distinct IDs still need explicit bindings;
names alone never merge people. Native mode verifies requested IDs directly when the roster
omits them. Missing people access, a changed cluster or a failed read stops the run with an
explanation. Disable native mode to use unconnected accounts with existing bindings.

Saved person IDs, groups, relationships and confirmations stay intact. Native access evidence
is refreshed for each run and is never exported as a permanent binding. When Immich retires a
saved ID (two records merged, re-clustered or deleted), the next film or visit to the People
page links the person to the one Immich person that carries their name and no one else here
holds, keeping every answer. With no single match, the People page asks you to fix the name in
Immich.

Only selected owners enter the film. Exact copies retain both owners' stars and faces;
similar images stay separate. Downloads, previews, reruns and render workers keep using owner
keys. A people condition holds per picture, not per episode: with AND, every named person
must be recognised on that same picture, which can span owners when native sharing allows it.

## Link the same person across accounts

Each Immich account gives the same person its own id, so the app has to be told who is who. It never guesses from names alone.

Open **Settings > People**, find the person, and under **Accounts** open **Link a person from partner**. The list shows everyone the partner account has named, with their picture counts and faces. Anyone with the same name (any case) or the same birth date comes first:

- **Link** connects them.
- **Not the same person** is remembered, so that suggestion never comes back.

A linked person shows by name, with **Open in Immich** (it uses `immich.public_url` when you set it, the server address otherwise) and **Unlink**. Unlinking takes the other account's id off the person and leaves everything you confirmed about them alone.

![Person settings with a partner-account person linked by name](https://sam-dumont.github.io/immich-memories/img/screenshots/people-accounts-bind.png)

Linking is manual: the app does not compare faces across the two libraries.

The same thing from the terminal needs the partner's id, from the `/people/<id>` part of the URL when the other owner opens that person in Immich:

```bash
immich-memories people bind "Lou" --account partner --id <person-id-in-partner-account>
```

A link preserves the person's confirmed details. An ID already linked to somebody else is refused.

### Who owns each account

Each account has its own owner too, because the primary account's owner and the partner's are usually different people. **Settings > People > Account owner** shows one row per account. For the partner account the app asks Immich once who the key belongs to, and matches that name against the people it holds. Pick someone else, or **Nobody in this library**, and the answer stays.

## Read both accounts into one film

```bash
immich-memories generate \
  --accounts primary,partner \
  --person "Lou" --memory-type person_spotlight --year 2026
```

In the web **New memory** page, select both under **Immich accounts to read**.

![New memory brief with both household accounts selected](https://sam-dumont.github.io/immich-memories/img/screenshots/memory-brief-accounts.png)

The scope is exact: `primary,partner` reads both; `partner` alone excludes your primary.
Omitting accounts reads primary only. Identical files count once, downloads use the owning
account, and either owner's favourite counts. If one selected account cannot be read, the run
stops instead of silently omitting that account’s pictures. A [free-text ask](https://sam-dumont.github.io/immich-memories/docs/make/free-text.md)
follows the same scope: without `--accounts` it only searches the primary's pictures.

Albums and trips still use primary only: `--accounts` is refused for those recipes.
[Duplicates and sharing](https://sam-dumont.github.io/immich-memories/docs/how-it-chooses/family-audience-duplicates.md) covers the selection rules.

## What automation does across accounts

Set the same account scope for daily discovery:

```yaml
advanced:
  automation:
    accounts: [primary, partner]
```

Docker equivalent, in `environment:`:

```yaml
      IMMICH_MEMORIES_AUTOMATION__ACCOUNTS: '["primary", "partner"]'
```

Check the next proposal without making it:

```bash
immich-memories auto suggest
```

Trips stay primary-only. Saved-group films can use both accounts.
[Automation](https://sam-dumont.github.io/immich-memories/docs/make/automate.md) explains priorities and cooldowns.

## Saved groups

Save a repeated people condition, so you don't retype `--person` every time:

```bash
immich-memories people group add "Kids" '"<kit-id>" OR "<remy-id>"'
immich-memories generate --group "Kids" --accounts primary,partner --memory-type multi_person --year 2026
```

Use store person IDs from `people show`, so renaming does not break the group. The UI has
**Saved groups** in People settings and group chips in the memory brief.
[The complete group syntax](https://sam-dumont.github.io/immich-memories/docs/run/reference/household.md#saved-groups) is in the reference.

![Saved people groups in Settings](https://sam-dumont.github.io/immich-memories/img/screenshots/people-saved-groups.png)

### Someone only the partner account knows

The scan reads primary only, so a partner-only person needs an explicit entry: export the
registry, add them with the partner's ID, and import it back.
[The export/add/import steps](https://sam-dumont.github.io/immich-memories/docs/run/reference/household.md#someone-only-the-partner-account-knows)
are in the reference; Docker users also have the
[host export and container import commands](https://sam-dumont.github.io/immich-memories/docs/make/cli/people.md#export-and-edit).

## Privacy notes

With local rendering, the partner key goes to its configured Immich server. A configured
[render worker](https://sam-dumont.github.io/immich-memories/docs/better/gpu-render.md) also receives the keys needed for the selected cut,
including partner keys, so that host has access to those libraries. The app reads the selected accounts' owned
pictures; partner sharing does not pull in a third person's library. Keys are redacted from logs
and diagnostic reports. Uploads always go to the primary account.
[Account-name rules and fields](https://sam-dumont.github.io/immich-memories/docs/reference/config-reference.md#extra-accounts) are in the reference.
