Reliquary Alpha
Docs menu

Docs / Concepts

Members and invites

People join a vault only by invite, with a role an owner picks, and only the owner of a vault manages who is in it.

Members

A vault's members are on Settings, Members, in three sections: People, Pending invites and Agents. Every member sees who else is in the vault, each with their role and shown as they chose (see How people are shown), and how many of the vault's places are filled. Owners also get:

  • Invite someone, at the top right: a page with an email address (or blank, for a link anyone may use) and a role (owner, editor or viewer). When the vault has no places left, the button is off and the page says how to make room (see Plans and limits).
  • A role menu with Change for each member, and Remove in the row's ⋯ menu, behind a confirm page.
  • Pending invites, with when each was sent and expires, and Revoke behind a confirm page.
  • Agents: each member's connections that reach this vault (tokens, apps and the Reliquary CLI), with each one's type, when it was created and last used, and Revoke behind a confirm page, which cuts that connection off from this vault only. See Connections.

The only owner can't step down, leave or remove themself. Make someone else an owner first. The one way a vault loses its last owner is that owner deleting their account.

Managing members is in the ceiling: no agent can do any of it, and no agent ever learns members' email addresses.

A vault with no owner

When a vault's only owner deletes their account and other members remain, the vault is left without an owner. Every member sees This vault needs an owner at the top of its pages.

  • Members keep reading, writing and proposing as their roles allow.
  • Nobody can do what only an owner may: change rules or members, invite people, export or delete the vault. Its waiting invites were withdrawn when the owner left.
  • Any member can choose Become owner. The first to choose it is the owner; anyone after them is told the vault has one. Nobody is made an owner without choosing it.
  • Becoming the owner counts the vault against your plan, as if you had created it, and from then on it takes its people and storage limits from your plan. If you're at your plan's vault limit, you're refused and told so: delete a vault you no longer need, or ask for a bigger plan. Until someone takes it, the vault has the Free plan's limits.
  • Only you can choose it, signed in to the web app: it's in the ceiling.
  • The last member of a vault with no owner can't leave it, since nobody could reach or delete it after. Become its owner, then delete it.

Invites

An invite is a link with a role, for one email address or for anyone who holds it:

  • An address invite works once, for 7 days, and only for someone signed in with that address. The address matches however it is typed: upper or lower case, and an accent typed as one character (é) or as a letter and a combining accent.
  • A link with no address (an owner leaves it blank and sets a use count, 1 to 100, instead) works for whoever opens it, up to that many people, also for 7 days; each join counts as one use, and it's spent once they're used up. Whoever opens it supplies their own email during sign-up: the link itself is what's scarce, not an address.
  • Reliquary emails an address invite's link to the invited address when the server has an email sender. When it has none, or the email can't be sent, or the invite has no address at all, the owner copies the link, shown once, and sends it.
  • Inviting the same address again replaces its earlier invite.
  • An owner can have at most 50 invites waiting in a vault (a link with no address counts as one, whatever its use count), and one person can create 20 an hour.

The person opens the link, signs in (or is asked to, and comes back), and joins with that role. Someone who already has an account with an address invite's address can instead choose Join or Decline on it in their Inbox; declining ends the invite, and the vault's log says so. A link with no address never appears in anyone's Inbox: there's no address to match it to. Joining by invite, either kind, also lets a new account create vaults at once, without waiting in the line. See Invite someone.

Leaving and removal

Any member can leave from the Danger zone at the bottom of Settings, General: Leave this vault, after a confirm page. A removed or departed member, and their agents, lose access at once: tokens that reached only that vault are revoked, and the vault drops out of tokens that reached several. Coming back takes a new invite.

Leaving, removal and role changes are logged, by id, never by email.

How people are shown

Where the web app names a person (Activity, proposals, threads, the Inbox, Members), it shows their email if they share a vault with you now, with their display name before it if they set one ("Ana Ruiz (ana@example.com)"; see Display name). Someone who chose to hide their email shows as their name and a short tag ("Ana Ruiz · 3f2a1b9c"; see Show me to others as). Anyone else, like a former member, shows as a short id. Agents see people by display name and tag only, never an email.

For agents: this page as Markdown, and every page at /llms.txt.