Tenants & Gardens¶
Kamerplanter is a multi-tenant platform: your data is organised in tenants — isolated containers, each mapped to a single type of organization. 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.
| Tenant type | Use case | Example |
|---|---|---|
| Personal | Private garden, balcony garden, houseplants | Your own garden |
| Organisation | Community garden, club, business | "Green Oasis e.V.", cannabis cultivation association |
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.
Personal data stays private
Your personal tenant is completely isolated from all other tenants. No member of another tenant can see your private houseplants or balcony garden — even if you belong to the same community garden.
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.
- Click the tenant name in the navigation bar
- A dropdown opens showing all your tenants
- 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¶
- Click the tenant selector in the navigation bar
- Choose Create new garden
-
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 -
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¶
- Navigate to Settings > Members > Invite
- Enter the member's email address
- Choose the role (Admin, Grower, Viewer)
- 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¶
- Navigate to Settings > Members > Generate Invitation Link
- Optionally set:
- Maximum number of uses (e.g. 20)
- Expiry date (e.g. in 30 days)
- Role new members will receive
- Copy the link and share it (WhatsApp, notice board, email list)
Ideal for large groups
The invitation link is especially practical for community gardens: pin it at the garden gate or include it in the association newsletter. Anyone with the link can join until the limit is reached.
Method 3: OIDC (OpenID Connect) 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¶
| Task | Admin | Grower | Viewer |
|---|---|---|---|
| Read everything | Yes | Yes | Yes |
| Create/edit plants | Yes | Yes | No |
| Create/edit locations | Yes | Yes | No |
| Create tasks | Yes | Yes | No |
| Document harvests | Yes | Yes | No |
| Invite members | Yes | No | No |
| Change roles | Yes | No | No |
| Change tenant settings | Yes | No | No |
The full permission overview — including platform roles, service accounts, and the question of who sees which data — is available under Roles, Tenants & Visibility.
Planned community features are missing from this table
The bulletin board, watering rotation, and shared shopping list are not yet implemented (see Community Features below) and therefore do not appear here as a permission.
Changing Roles¶
- Navigate to Settings > Members
- Click the edit icon next to the desired member
- Choose the new role
- Confirm — the change takes effect immediately
Attributing Plots¶
A garden is a shared working set: all growers tend all plants and tasks. A plot attribution therefore records who looks after it — it locks nobody out.
- Attributed plots: The member finds "their" plot faster; editing stays open to all growers.
- Communal areas such as compost or greenhouse need no attribution at all.
- Viewers read everything and change nothing — regardless of attributions.
The practical benefit: when someone drops out at short notice, another member steps in without an admin having to change anything first.
Keeping something truly private
Separation always runs along the garden boundary, never inside a garden. Whatever concerns only you belongs in your personal garden — or in another garden, which you can create at any time.
Partially available: Plot attribution
So far, attributions can only be created via the programming interface — there is no user interface for them yet. Details under Roles, Tenants & Visibility.
Community Features¶
Not yet implemented
The bulletin board, watering rotation, and shared shopping list are planned for community gardens but currently exist neither in the backend nor in the interface. The sections below describe the intended scope.
Bulletin Board¶
The bulletin board will be a shared message area for all tenant members: members will be able to publish posts, and admins will be able to pin and delete posts.
Typical bulletin board posts (concept)
- "Slug alert! Please set out beer traps."
- "Saturday 10am: Community compost turning."
- "Too many courgettes — who wants some?"
Watering Rotation¶
A rotation feature is planned for distributing watering duties among members: an interval (e.g. weekly) and the participating members will be configurable, and the system will remind the responsible member each week. Members will be able to swap duties among themselves without involving the admin.
Shared Shopping List¶
A shared shopping list is planned: all growers will be able to add entries and tick them off, and admins will be able to archive lists.
Tenant Settings¶
As an admin, you can access all settings under Settings (gear icon).
Key Settings¶
| Setting | Description |
|---|---|
| Name & Slug | Display name and URL short name |
| Master data assignment | Which global plant species are visible |
| Invitation settings | Default role for new members |
| OIDC configuration | Auto-join via external identity provider |
Changing the slug breaks URLs
If you change the slug, all URLs within the tenant change. Bookmarks and shared links become invalid. Only change the slug if necessary.
Leaving a Tenant¶
You can leave a tenant as long as you are not the only admin:
- Navigate to Settings > Membership > Leave Tenant
- Confirm
If you are the only admin
If you are the only admin, you must either promote another member to admin first, or delete the tenant.
Frequently Asked Questions¶
Can I share data between tenants?
No — resources always belong to exactly one tenant. Cross-tenant sharing is deliberately not possible to ensure data isolation. Global master data (plant species, pests) is however visible to all tenants.
How many tenants can I create?
There is no technical limit. You can create and join as many tenants as you like.
What happens to my data when I delete a tenant?
All resources of the tenant are deleted. Your personal tenant and your memberships in other tenants are not affected.
Can tenant admins see my personal houseplants?
No. Your personal tenant is completely isolated from all other tenants. Even if an admin has more rights in the community garden, they can never see data in your personal tenant.