> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kombify.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Households

> Invite people to your household, choose what they may use and remove them again

A household is the group of people who share a homelab. You are its owner. Two
kinds of people can belong to it, and they differ in what they get.

## Two kinds of members

| | kombify member | Homelab member |
| - | - | - |
| Has | Their own kombify account | A sign-in on the homelab itself |
| Can use | What you allow of your plan in kombify Cloud, such as AI chat and the Feed of the household | The apps of your homelab, such as Photos, Files, Media and Smart Home |
| Limit | The number depends on your plan | Not limited |

A homelab member does not need a kombify account and does not use up a place for
kombify members. You add one on the homelab itself. See
[`stackkit user`](https://docs.kombify.io/stackkits/reference/cli/user), which prints a one-time link
for the person to set up their passkey.

> [!NOTE]
>
> Setting up a homelab sign-in for a kombify member from the dashboard is in
> preview.

## What you need first

* A kombify account. See [Create an account](https://docs.kombify.io/apps/cloud/get-started.md).
* The e-mail address of the person you invite. They sign in with an account
  that uses that address.

## Invite a kombify member

**1. Open Household**

Open **Household** in the left rail of the dashboard. If you have none yet,
give your household a name and choose **Create household**.

**2. Send the invitation**

Choose **Invite**, enter the e-mail address and choose what the person may
use. You can change this later. Choose **Send invitation**.

**3. Share the link**

kombify shows an invitation link and a **Copy link** button. The link works
once, belongs to that e-mail address and expires after 14 days. If the
person already has an account, the invitation also reaches their Feed.

**4. The person accepts**

The person opens the link, signs in with the invited account and chooses
**Join household**. Messages and shares from your household then appear in
their Feed.

Open invitations are listed under **Open invitations**. Choose the withdraw
button to cancel one. A link for another e-mail address, or one that was used,
withdrawn or has expired, is refused with a message that says which.

## The activation link

When your homelab already knows the new member, the confirmation page offers
**Set up homelab sign-in**. This is a one-time activation link for the sign-in
on the homelab. It is valid until the time shown on the page. A member can also
start it later from their own entry in **Household**.

## Remove a member

Open the person in **Household** and choose **Remove**, then confirm. They lose
access to everything you share in the household. A member can leave by choosing
**Leave household**. The owner cannot leave.

## If something goes wrong

* If the invitation says the e-mail address does not match, sign in with the
  address the invitation was sent to.
* If an invitation is refused because of a limit, check how many invitations
  are still open and withdraw the ones you no longer need. How many kombify
  members you can have depends on your plan; see
  [Plans and billing](https://docs.kombify.io/apps/cloud/plans-and-billing.md).
* For anything else, write to [info@kombify.io](mailto:info@kombify.io).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.