# Oobeya Installation Tutorial (OpenShift)

{% hint style="warning" %}
**Warning**: the setup in this document is possible with `Storage Class`.
{% endhint %}

The `oobeya-ui` service and its `init containers` must be run using a dedicated `Service Account` within the OpenShift environment due to their operational requirements. The necessary security permissions must be assigned to this Service Account. These elevated permissions are restricted solely to the required components, while all other pods continue to operate under the default security policies.

{% hint style="info" %}
**Note**: The Ingress object is used to access the application interface and is specified in the `route.yml` file. You need to change your DNS settings.
{% endhint %}

***

### Installation Steps

* Please switch to the oobeya project.
* If it doesn't exist, please create a namespace for Oobeya.

```
$ oc create namespace oobeya
```

* Request a token from the Oobeya team for registry access.

```
$ oc secret docker-registry oobeya-secret \
      --docker-server=https://oobeya.azurecr.io \
      --docker-username=(Credentials-Name) \
      --docker-password=(Your-Credentials) --namespace=oobeya
```

* You can download the Manifest files.

```
$ wget https://oobeya-app.s3.us-east-1.amazonaws.com/oobeya-oc-install.tar
```

```
$ tar -xvf oobeya-oc-install.tar && cd oobeya
```

### Configuration

* PVCs are given in `oobeya-mongo.yml` Enter the StorageClass name.
* To access Oobeya from the browser, you need to add the domain name or machine IP to the configuration.

```
$ vi (pwd)/configmaps.yml
```

Please edit this:

1. dashboard-configmap

```
CORS_ALLOWED_ORIGIN: "http://your-IP-or-Domain"
```

2. gateway-configmap

```
CORS_ALLOWED_ORIGIN: "http://your-IP-or-Domain"
OOBEYA_GATEWAY_BASE_URL: "http://your-IP-or-Domain"
```

### Deployment

You can run this command.

```
$ oc apply -f .
```

* By default, Oobeya broadcasts on port 80.
* When all services are '1/1 Running,' you can access Oobeya through your browser at '<http://your-IP-or-Domain>'.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.oobeya.io/installations/oobeya-installation-tutorial-openshift.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
