Appearance
Nextcloud admins — quick start
This section is for the Nextcloud administrator installing and configuring TeamHub for an organisation.
In five minutes
- Install TeamHub from the App Store (or upload the release zip and run
occ app:enable teamhub). - Wait for migrations to complete on first enable. TeamHub creates its own tables (
teamhub_*) but does not modify any existing Nextcloud tables. - Open the admin settings (
Settings → Administration → TeamHub) and:- Set the team-creator group — the group whose members are allowed to create new teams. Defaults to admin only.
- (Optional) Set the default tab layout for new teams.
- (Optional) Configure Group Folders integration if Group Folders is installed.
- Tell your users. Anyone in the team-creator group can now create teams. Anyone in a team can use it.
What TeamHub adds to Nextcloud
| Surface | What it is |
|---|---|
/apps/teamhub/ | The team home page — one per team. Defaults to the team's message stream. |
| Settings → Administration → TeamHub | Organisation-wide configuration. |
| Manage team (via Team info widget) | Member management, resource configuration, settings, integrations, audit log — accessible to team admins from the Team info widget on the team home. |
Database tables teamhub_* | TeamHub's own data: messages, widgets, integrations, audit log. Nextcloud's tables are untouched. |
What TeamHub does not do
- It does not replace Nextcloud Teams (Circles). A TeamHub team is a Nextcloud team — the same circle, the same members, the same membership API.
- It does not store copies of your calendars, files, or Deck boards. Those stay in the apps they belong to. TeamHub presents them.
- It does not add a parallel permission system. If a user can't see a calendar in Nextcloud, they won't see it in TeamHub either.
Next steps
- Installation → — full installation walkthrough, database requirements, upgrade notes.
- Configuration → — admin settings, Group Folders integration, defaults.
- Architecture → — design choices, data model, security boundaries.
- Troubleshooting → — common issues, logs, migration errors.