Databunker Pro Installation Guide

πŸ“₯ Clone Databunker Pro Setup Repository

All installation scripts and configuration files are available in our public GitHub repository:

πŸ”— https://github.com/securitybunker/databunkerpro-setup

To get started, clone this public repository:

1
2
git clone https://github.com/securitybunker/databunkerpro-setup.git
cd databunkerpro-setup

This repository contains:

  • Helm charts for Kubernetes deployment
  • Docker Compose configurations for both MySQL and PostgreSQL
  • Setup scripts for generating initial credentials and keys
  • Production-ready configurations with external database support

🐳 Deploy Databunker Pro via Docker Compose

1. Choose Your Database

After cloning the repository, navigate to the appropriate directory:

The repository provides two Docker Compose configurations:

For MySQL (Percona 8):

1
cd docker-compose-mysql

For PostgreSQL:

1
cd docker-compose-pgsql

3. Prepare Environment

If you want to generate initial database access credentials, SSL keys, and a wrapping key, run the provided generate-env-files.sh script:

1
./generate-env-files.sh

4. Deploy Databunker Pro

  1. Pull the latest images:
1
docker compose pull
  1. Start the services:
1
docker compose up -d

☸️ Deploy Databunker Pro via Kubernetes

1. Add the Helm Repository

The official DatabunkerPro Helm chart is available through GitHub Pages:

1
2
3
4
5
# Add the Helm repository
helm repo add databunkerpro https://securitybunker.github.io/databunkerpro-setup

# Update your local Helm repository cache
helm repo update

2. Install DatabunkerPro

1
helm install databunkerpro databunkerpro/databunkerpro

3. Expose the Service

After installing the databunkerpro Helm chart, you need to expose the Databunker Pro service:

1
kubectl port-forward service/databunkerpro 3000:3000

Then, open http://localhost:3000 in your browser to finish the setup process.

For production environments, we strongly recommend using external databases (AWS RDS, Google Cloud SQL, etc.) instead of internal databases. See the GitHub repository for detailed configuration examples.

Note: Start with one pod initially. After completing the setup, you can scale to more pods.

βš™οΈ Initial Setup

  1. Once the databunkerpro container is started, check the service logs to find the Access Code.

Databunker Pro Setup - Extract Access Code

  1. Open the Databunker Pro setup page in your web browser.
  2. You will see the following screen:

Databunker Pro Setup - Validate Access Code

  1. Enter the Access Code found in the service logs.
  2. Upon successful check, the service will generate encryption and access keys, and create the database.
  3. You will then see the completion page:

Databunker Pro Setup - Setup is ready

  1. Make sure to securely store the Root Access Token, Wrapping Key, and Shamir Key Shares.
  2. Click the Start Databunker Pro button to start the Databunker Pro service.

πŸŽ‰ Post-Installation

After completing the setup, you can now use the Root Access Token with the API to save or retrieve data.

πŸ”’ Security Notes

  • Databunker Pro uses an internal Master Key to encrypt the data. This key is automatically generated and never revealed.
  • The Wrapping Key is used to encrypt the internal Master Key, adding an extra layer of security.
  • Regularly rotate the Wrapping Key to enhance security.
  • In case of a lost or compromised Wrapping Key, you can use any 3 out of 5 Shamir Key Shares to generate a new one.

πŸ“ˆ Scaling (Kubernetes)

Once the Databunker Pro is installed and configured in Kubernetes, you can now scale to more replicas:

1
kubectl scale deployment databunker-pro --replicas=3

Adjust the number of replicas as needed for your use case.

For any additional assistance or questions, please refer to the Databunker Pro documentation or contact the support team.

πŸ‘‹ Hello from the Databunker Team

Our developer team will be happy to customize Databunker for your specific needs!