Introduction
Crewhall is a team workspace that your organization runs on its own server. Chat, files, documents, tasks, meetings and shared passwords live in one app, with one sign-in, one search and one permission model. These docs explain how to use it and how to run it.
What is in Crewhall
Each area of Crewhall is a module. Modules appear in the left menu, and your organization's admins decide which ones are turned on.
| Module | What it is for |
|---|---|
| Chat | Channels, direct and group messages, replies, reactions, file previews and calls. |
| Drive | Folders and files with sharing, versions, trash and previews. |
| Pages | A wiki that several people can edit at the same time, with templates and imports. |
| Boards | Task boards with kanban, list, backlog with sprints, timeline and workload views. |
| Drawings | A shared whiteboard the whole team edits at once. |
| Meetings | Video meetings, persistent rooms and guest access. |
| Calendar | Personal and space calendars, rooms and desks, and sync with Google or Microsoft calendars. |
| Vault | Password sharing with zero-knowledge encryption. The server never sees decrypted data. |
| Portal | A public documentation and blog site that you manage from the workspace. |
| Directory, Mail, Forms, Tables, Automations, Tools | See More modules. |
The Home screen ties these together with quick access cards for links, notes, files and the work assigned to you. Announcements and a thank-you wall keep the team informed. See Getting started for a tour.
You can use Crewhall in a web browser, in the desktop app for Windows and macOS, and in the mobile app for iOS and Android. The interface is available in English and Turkish.
Spaces
Content in Crewhall lives in spaces. A space holds the Drive files, pages, boards, drawings, forms, tables and automations of one team or project.
- Personal space. Every person has one. It is marked "Only you", and nobody else sees what is in it unless you share an item.
- Shared spaces. A team, department or project gets a shared space. Its members see its content according to their role.
Each member of a shared space has one of four roles:
| Role | What the person can do |
|---|---|
| Owner | Everything. Can delete the space and transfer ownership. |
| Admin | Manages members and settings. |
| Editor | Creates, edits and shares content. |
| Viewer | Views, comments and downloads. |
Some modules are not organized by space. Chat, Calendar, Meetings, Vault and Mail have their own structure, such as channels, calendars or vaults, and you reach them directly from the left menu.
Separately from space roles, each person has an organization role: Owner, Admin, Member or Guest. Org admins manage members, spaces, branding, sign-in methods and security policies. Guests have limited access; for example, they cannot use the vault. See Administration.
Who it is for
Crewhall is for organizations that want their team's daily tools in one place and their data on their own server.
- Teams get chat, files, documents, tasks and meetings that share permissions and search, instead of separate subscriptions.
- IT and operations teams run Crewhall on a single Linux server with Docker Compose. See Self-hosting.
- Developers can extend Crewhall with plugins, and AI assistants can work in the workspace through MCP with the scopes you grant. See Plugins and MCP.
Crewhall shows your organization's name, logo and colors, which admins set in the admin panel. The product name stays in the background.
License
Crewhall is source-available. The code is public and free to use, change and run for your own people, inside an organization of any size. It is licensed under the Apache License 2.0 with the Commons Clause, which means you may not sell Crewhall, offer it to others as a paid hosted service, or charge for consulting or support related to it. Because of that condition, Crewhall is not open source as the Open Source Initiative defines the term. The plugin SDK is MIT licensed, so you can build and sell plugins freely. The LICENSE file in the source code is the binding text.
Where to go next
- Getting started: sign in and find your way around.
- Desktop app: notifications, tray and Drive folder sync on Windows and macOS.
- Administration: members, spaces, branding and security for admins.
- Self-hosting: install and run Crewhall on your own server.
- Plugins and MCP: extend Crewhall and connect AI assistants.