Containerization

Using Docker is a convenient way to start without installing system dependencies, as we have handled that for you. We plan to provide more containerized versions of our WriteBackExtreme application, such as Podman images Current version of WriteBackExtreme Docker is running on Debian 12 - Bookworm.

Docker for WriteBackExtreme is production ready since version 5.2.0. All versions before are not ready for production.

About the Docker image

The default exposed port of the application is 8090.

Within the Docker image, a folder is created at the path /app_data that contains files and logs, ensuring persistence for the database.

The default repository database used is: SQLite

The initial configuration of the application is stored in a file named wbe.config.yaml. In our Docker image, there are two files that remain persistent during upgrades.

• Configuration file: wbe.config.yaml

• SQLite database: writebackextreme.sqlite

Configuration via Environment variables

The following environment variables are available and can be passed on into the Docker Container.

Key	Type	Required?	Description
WBE_LICENSE	String		Content of your license**
WBE_URL	Url		External URL you want to reach the application on ***
WBE_NUM_WORKS	Number		Number of workers, defaults: 4, required minimum of 2 works

*** The external URL can be a company domain e.g. wbe.company.com. When testing locally you can provide a localhost url. default can be: localhost:8090

** the content of a license can be found in our portal.

Getting started

The setup process is designed to be easy and painless. Therefore, the application comes preinstalled with a generic admin account by default.

1. Before starting, ensure you have a WriteBackExtreme license, which can be downloaded via our portal.
2. Available URL e.g. writebackextreme.company.com

Please choose one of the following solutions to set up with:

Docker standalone

Docker compose

Connecting with databases

The majority of database are able to connect with their databases right away. But some database required setups like: Snowflake, Databricks and the once with ODBC for example.

Read the following article to read how to use those connections.

Roadmap

This documentation will be actively updated, but there are a few things we want to push out in the future:

• Documentation to help with setup on cloud solutions:

  • Kubernetes.

  • Cloud hosting providers like Azure, AWS, etc.

• How to set up with Windows Server.

• WriteBackExtreme with Windows Containers only (without the Hyper-V component)?

• Make it even easier to setup.

• Guided custom setup.

If something is missing, please reach out to us!

These roadmap items are ideas we have, and based on requests, we help out and document the process.