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

  1. Download beControl and go to the deployment folder.

    git clone https://gitea.lab48.be/eliott/beControl.git
    cd beControl/deploy/docker
  2. Copy the example configuration and set your passwords and secret keys.

    cp .env.example .env
    # POSTGRES_PASSWORD, JWT_SECRET, MFA_ENCRYPTION_KEY, CORS_ORIGINS
  3. 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

  1. Organisation

    Set your name and logo, add and verify your mail domains.

  2. People

    Create users and groups, or connect your existing directory. Decide who administers what.

  3. Security baseline

    Choose the password and session policy, require multi-factor sign-in, add your first conditional access rules.

  4. Services

    Create file sites and quotas, review chat settings, connect an AI model if you want one.

  5. 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.