Oobeya Installation Tutorial & Requirements (Docker)

Install Oobeya On-Premise Edition on a dedicated Linux server or virtual machine using Docker Compose.

This deployment model is a good fit for organizations that want to run Oobeya inside infrastructure they control without operating a Kubernetes cluster.

For Kubernetes-based environments, use the Helm, Kubernetes, or OpenShift installation guides instead.

---

PREREQUISITES

If you want to run Oobeya on a server (VM, AWS, Azure, GCP, etc.) without any performance issues, you should set the minimum resources as follows:

Minimum Hardware Requirements:

• 16GB RAM (The server requires at least 16GB of RAM to run efficiently for enterprises.)

• 8 CPU / 4 Cores

• 100GB Disk Space

For advanced infrastructure sizing guidance, see Oobeya On-Premise Infrastructure Requirements.

For large enterprise deployments, validate sizing with the Oobeya team before production rollout.

Container Runtime

The Docker installation requires:

• Docker Engine

• Docker Compose

Supported External NoSQL Databases

• MongoDB Atlas, Azure CosmosDB, AWS DocumentDB, GCP Firestore, Custom MongoDB Server.

Container Registry Access

Allow outbound HTTPS access to the required Oobeya container registry:

oobeya.azurecr.io

If direct outbound registry access is not allowed, organizations can use an approved internal registry mirror or an offline image-transfer process.

Coordinate offline or restricted-network installations with the Oobeya team before deployment.

Request Oobeya Registry Credentials

Oobeya application images are distributed through the Oobeya container registry. You will need registry credentials provided by the Oobeya team before starting the installation.

Request Your Docker Credentials

---

On-Premise Installation Video

Installing Oobeya Using Docker Compose

Follow the steps below for the quick and easy installation of Oobeya to work with your data.

1- Create a new working directory.

mkdir oobeya
cd oobeya

2- Download the Oobeya installation package.

wget https://oobeya-app.s3.amazonaws.com/oobeya-configs.zip

3- Unzip the installation package.

unzip oobeya-configs.zip

4- Edit env.list file and enter your domain name or IP address (browse URL) for the following parameters:

env.list

CORS_ALLOWED_ORIGIN=https://oobeya.mycompany.com,http://<server-IP>
OOBEYA_GATEWAY_BASE_URL=https://oobeya.mycompany.com,http://<server-IP>

5- The mount volume directory uses the /data-oobeya directory by default. You can use the .env file to change it.

When the application is run, it automatically creates this directory; it is recommended to use a user with the necessary permissions to create the directory.

6- You need to log in to pull Oobeya images. The Oobeya Team will provide Docker login credentials. Request your credentials.

docker login -u {{user_name}} -p {{password}} oobeya.azurecr.io

7- Run the application using docker-compose.

docker-compose up -d

8- Navigate to the Oobeya browse URL to launch the Oobeya registration page. Then, set a new password for the root user of Oobeya.

9. Log in with the root user and explore Oobeya!

Now you are ready to connect your data sources with Oobeya to get complete visibility of your software's health.