Get started
Install beControl on a test machine, set up your organisation, and invite the first users.
What you need
- A Linux server with Docker Engine 24 or newer and Docker Compose v2
- 4 GB of memory for every service, 2 GB for sign-in and access only
- 20 GB of disk to start, more as mail and files grow
- A domain name pointing at the server, for HTTPS and mail
Install
-
Download beControl and go to the deployment folder.
git clone https://gitea.lab48.be/eliott/beControl.git cd beControl/deploy/docker -
Copy the example configuration and set your passwords and secret keys.
cp .env.example .env # POSTGRES_PASSWORD, JWT_SECRET, MFA_ENCRYPTION_KEY, CORS_ORIGINS -
Build the images and start the setup wizard.
docker compose build COMPOSE_PROFILES=setup docker compose up -d
The setup wizard
Open the address of your server in a browser. The wizard then:
- checks the database connection,
- registers your organisation and its domain,
- creates the first administrator,
- lets you choose which services to run,
- and starts them for you.
Your first day as an administrator
-
Organisation
Set your name and logo, add and verify your mail domains.
-
People
Create users and groups, or connect your existing directory. Decide who administers what.
-
Security baseline
Choose the password and session policy, require multi-factor sign-in, add your first conditional access rules.
-
Services
Create file sites and quotas, review chat settings, connect an AI model if you want one.
-
Devices
Upload the Apple push certificate if you manage Apple devices, then enrol a first test device.
For the people who use it
- Everyone signs in at one address and finds My Day, mail, calendar, contacts, files and chat there.
- Phones and desktop apps connect with the standard account types: mail, CalDAV for calendars, CardDAV for contacts.
- People manage their own sign-in methods and devices under Security information in their profile, and see their applications under My Apps.
Need a hand?
The documentation in the repository covers deployment, upgrades, backups and every admin page. If you would rather not do it yourself, our Supported and Managed plans include installation.