System Requirements

To be able to easily securely and properly operate a Brezel instance, you need to provide a server that meets the following basic requirements.

Application setup, such as the web server, database, and other software is not covered here and not required for you to set up or provide. Any dependencies we need will be installed by us during the setup process.

Hardware Requirements

A simple Brezel instance requires the following minimum system specifications:

• At least 4 x86 CPU cores
• At least 8 GB of RAM
• At least 50 GB of storage

Note

Higher specs (e.g. 16 GB or more of RAM) are recommended for instances that are intended to be used by many people at once or utilize more complex processes.

For example, if your brezel will handle lots of files, more storage is needed. For many workflows that run often and possibly longer, more CPU cores are beneficial. And the more users you expect to use the system at once or the more complex the workflows in your brezel are, the more RAM is needed.

Operating System

Any recent (preferably LTS) server Linux distribution should work.

We often operate “Ubuntu Server”, but “Debian Server” or others should work as well.

We prefer a blank installation without any additional software like “Plesk”!

We will install all required software ourselves.

Any additional software may complicate the process and could cause issues during setup, maintenance or operation!

Server Access / Web & Internet requirements

• SSH access to the server with sudo permissions
  • We need sudo permissions to install the necessary software packages, properly configure the server, and set up the Brezel instance correctly.
    • For example, since some components of Brezel are containerized, a container runtime like Docker is required. We will also install and configure this, which requires sudo permissions.

    Note

    Setting up Brezel in an environment without sudo permissions is possible although with some limitations and additional effort. Please contact us to discuss your options.

  • During the setup process we will create a new user and disable password-based SSH access in favor of certificates for security reasons. The initial access may be granted with a password.

    Note

    This is negotiable and if your server has other things running on it, we will not tinker with your SSH security settings. Our user will still be using certificate based SSH authentication for CI/CD and maintenance access.

• The server needs to be able to talk to and access the open internet freely.
  • This is required to install required packages and to access external services like LetsEncrypt.
• A public (reachable), static IP address

  • This needs to be accessible from the internet without needing a VPN.

    Note

    This is required and non-negotiable! It is needed for us to set up a CI/CD process to be able to properly maintain and update your Brezel.

    And as Brezel is a Web-based application most benefits like easy access from any device from anywhere, even if “in the field” would be lost if requiring a VPN. If your use case still requires restricting access to your Brezel instance to be only possible “in-house”, please contact us to discuss your options before commiting to a server / infrastructure choice! The important bit is, that we need to always be able to reach the server from the internet via SSH.

  • Port forwarding and unrestricted traffic on the following ports on that IP:

    • 22 (SSH)
    • 80 (HTTP)
    • 443 (HTTPS)
• DNS configuration for 3 different Domains (or subdomains) pointing to the server’s IP address
  • One to access the Brezel instance during normal use (e.g. brezel.example.com)
  • One for the API (e.g. api.brezel.example.com or brezel-api.example.com)
  • One for a websocket server (e.g. ws.brezel.example.com or brezel-ws.example.com)

Recommended Servers / Examples

We recommend using a virtual server from a provider like Hetzner Cloud or netcup.

Some examples for servers that meet the minimum system requirements are:

• [Hetzner Cloud] CX32 (4 x86 vCPUs, 8 GB RAM, 80 GB Storage)
• [Hetzner Cloud] CPX31 (4 x86 vCPUs, 8 GB RAM, 80 GB Storage)
• [Hetzner Cloud] CAX31 (4 x86 vCPUs, 8 GB RAM, 160 GB Storage)
• [netcup] VPS 1000 G11 (4 x86 vCPUs, 8 GB RAM, 256 GB Storage)

These all provide the necessary resources to run a basic Brezel instance and omit any unnecessary software that might interfere with setup and operation like “Plesk”, a VPN or others.

Note

The exact servers mentioned above are examples and may not be available in the future. Please check the current offerings of the provider.