Tenants & Gardens¶

Kamerplanter is a multi-tenant platform: your data is organised in tenants — isolated containers that correspond to exactly one organisational form. You can be a member of multiple tenants at the same time, for example your private balcony garden and the community garden of your association.

What Is a Tenant?¶

A tenant is the central isolation container for all resources: plants, locations, tasks, harvests and care data always belong to exactly one tenant. Other tenants cannot see this data.

Personal Tenant¶

When you register, the system automatically creates your personal tenant. You are automatically the admin there. All resources you create in Kamerplanter land in your personal tenant by default.

Switching Between Tenants¶

If you are a member of multiple tenants, you will see a tenant selector in the top left of the navigation bar.

1. Click the tenant name in the navigation bar
2. A dropdown opens showing all your tenants
3. Click the desired tenant — the view switches immediately

The currently active tenant is highlighted in the navigation bar. The URL contains the tenant slug: /t/green-oasis/locations/...

Creating a Community Garden¶

Create a New Tenant¶

1. Click the tenant selector in the navigation bar
2. Choose Create new garden

3. Fill in the form:

   Field	Description	Example
   Name	Display name of the garden	Green Oasis e.V.
   Slug	URL-friendly short name (auto-generated)	green-oasis
   Type	Type of organisation	Organisation
   Description	Short description (optional)	Community garden in Westpark

4. Click Create

You are automatically the admin of the new tenant.

Inviting Members¶

As an admin you can invite members in three ways:

Method 1: Email Invitation¶

1. Navigate to Settings > Members > Invite
2. Enter the member's email address
3. Choose the role (Admin, Grower, Viewer)
4. Click Send Invitation

The system sends an invitation email. After clicking the link in the email, the user is added to your tenant with the pre-selected role — whether they register fresh or already have an account.

Method 2: Invitation Link¶

1. Navigate to Settings > Members > Generate Invitation Link
2. Optionally set:
   • Maximum number of uses (e.g. 20)
   • Expiry date (e.g. in 30 days)
   • Role new members will receive
3. Copy the link and share it (WhatsApp, notice board, email list)

Method 3: OIDC Auto-Join¶

For associations and organisations with their own identity provider (Keycloak, etc.), the OIDC integration can be configured so that new users automatically join the tenant. This is set up by the platform administrator.

Roles and Permissions¶

Each member has exactly one role per tenant. The role determines what they are allowed to do:

Role Comparison¶

*Growers can edit locations assigned to them.

Changing Roles¶

1. Navigate to Settings > Members
2. Click the edit icon next to the desired member
3. Choose the new role
4. Confirm — the change takes effect immediately

Location-Based Write Access¶

In a community garden, not every member should be able to edit every plot. The assignment system controls who can edit which locations:

Assigning a Location to a Member¶

1. Navigate to Locations > desired location
2. Click Edit Assignment
3. Select the member from the dropdown
4. Click Save

Rules for location assignments:

• Assigned locations: Only the assigned grower and admins may edit
• Unassigned locations: All growers in the tenant may edit (communal areas)
• Viewers: Always read everything, regardless of assignments
• Admins: Can always edit everything

Community Features¶

Bulletin Board¶

The bulletin board is a shared message area for all tenant members.

1. Navigate to Community > Bulletin Board
2. Click New Post
3. Write your message and click Publish

Admins can pin posts so they appear at the top, and can delete posts.

Watering Rotation¶

For distributing watering duties among members:

1. Navigate to Community > Watering Rotation
2. Click Create New Rotation
3. Set the interval (e.g. weekly) and add the members
4. The system reminds the responsible member each week

Members can swap duties among themselves — without involving the admin.

Shared Shopping List¶

1. Navigate to Community > Shopping List
2. All growers can add entries and tick them off
3. Admins can archive lists

Tenant Settings¶

As an admin, you can access all settings under Settings (gear icon).

Key Settings¶

Leaving a Tenant¶

You can leave a tenant as long as you are not the only admin:

1. Navigate to Settings > Membership > Leave Tenant
2. Confirm

Frequently Asked Questions¶

See Also¶

• Getting Started — Onboarding
• User Accounts & Authentication
• Locations & Substrates