Skip to main content
Install Collabase on one Linux server with Docker. You run one script, answer four questions and open Collabase in your browser. HTTPS, the database and all services are set up for you.

Choose how to run Collabase

All three run the same software. Hand System requirements to the team that provides the infrastructure.

Before you start

The installer checks the server and tells you if something is missing. The details, including network and outbound connections, are on System requirements.
The 4 GB minimum assumes live collaboration is on (the default). If you turn collaboration off, 2 GB is enough for a small install. See Sizing & scaling to match resources to your team.
macOS and Windows are supported for testing and local use. On Windows, use Docker Desktop with WSL2. Production runs on Linux.

How many users does it support?

These numbers apply to the current Beta and Release Candidate. They will be updated before general availability.
Collabase ships with tuned defaults. You do not need to tune anything for the numbers below.
The number of registered accounts has no impact on performance. What matters is how many people are actively using the app at the same moment. To match RAM and CPU to that number — and to spread Collabase across separate servers as you grow — see Sizing & scaling.

Installation

You will have received a deployment ZIP from Collabase. Copy it to your server and unzip it.
Then run the installer:
The installer will ask you four questions:
The database password is used internally by Collabase and is never entered in the app itself. It does not need to be memorable — a password manager entry works well.
After you confirm, the installer downloads all required components and starts Collabase. This typically takes 2–5 minutes depending on your internet connection. Once it finishes, you will see a confirmation message with your URL. Open it in your browser and log in.
Your server has no internet access? Follow the air-gapped installation guide instead. It installs from an image bundle.
If your URL is a real domain (e.g. https://collabase.yourcompany.com), HTTPS is set up automatically. No certificate configuration is needed.
AI features (the CollabaseAI assistant, writing assistance, AI automation) use the AI provider you configure after installation under Settings → AI settings → Language model — for example OpenAI, Anthropic, or your own Ollama server. They do not need extra server RAM.

First login

Log in with the admin email and password you set during installation. You will be asked to choose a new password on first login. After that, you can:
  • Go to Admin → Users to invite your team
  • Create your first Space for a project or department
  • Explore the settings under Admin to configure authentication, email, and more

Updating Collabase

To update to a new version, run:
The script backs up your database, checks it against the new version, downloads the new version and restarts everything. You do not touch any configuration file. The steps, the options and the rollback are on Updates.
Do not run install.sh again on an existing installation. Use update.sh for all updates.

Changing your URL or admin settings

If you need to change the URL or other settings configured during installation:
Your data is not affected — only the configuration is updated.

Managing your installation

The install script doubles as a management tool. Run it with a command: Options for updates, such as a dry run, a pinned version and a rollback, are on Updates.

Troubleshooting

Collabase did not start

The first start takes a little longer than usual — up to 3 minutes. If it still does not respond after that, check the logs:

Port 80 or 443 is already in use

Something else on your server is using a required port. Find it and stop it, then run the installer again:

CollabaseAI is not available

AI features need an AI provider to be configured. Go to Settings → AI settings → Language model, choose a provider (for example OpenAI or your own Ollama server), enter its access key, and click Save and test. Reload the page afterwards, because the AI chats button is only drawn once the setting has reached the browser. If the test succeeds and the assistant still does not work, contact Collabase support.

I need help

Open a support ticket or submit a question at collabase.featurebase.app.
Last modified on November 5, 2026