# Oobeya Installation Tutorial (Helm)

To install using the Helm Repository, you can follow the steps on [ArtifactoryHub](https://artifacthub.io/packages/helm/oobeya/oobeya).

If you want to proceed with the manual installation guide, follow the steps below:

{% hint style="warning" %}
**Warning:** Installation requires a valid **StorageClass.**

Before you begin, please ensure that your cluster has a configured **StorageClass**, as persistent volumes are required.
{% endhint %}

{% hint style="info" %}
**Note**: Oobeya uses an IngressRoute object to expose the application interface. The default configuration is provided in `_traefik-route.yml`.

\
The `routes` defined under the routes section are available for each Ingress provider.
{% endhint %}

### Install Oobeya Helm Chart

Please create a namespace for Oobeya.

```
$ kubectl create namespace oobeya
```

Please request a token from the Oobeya team for registry access.

```
$ kubectl create 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 chart package.

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

$ tar -xvf oobeya-helm-lts.tar && cd oobeya
```

### Configure Persistent Volumes

Persistent Volume Claim (PVCs) are defined in the following files:

```
$ vi (pwd)/values.yaml
```

```
storage:
    mongoStorage:
      pvcName: oobeya-mongo-pvc
      storageClassName: local-path                      # StorageClass Name
      size: 100Gi                                       # Storage Size

    gitwiserStorage:
      enabled: true
      pvcName: oobeya-gitwiser-pvc
      storageClassName: local-path                      # StorageClass Name
      size: 20Gi                                        # Storage Size
```

Edit file to set the correct StorageClass name for your environment.

### Configuration

To access Oobeya from the browser, you need to add the domain name or machine IP to the configuration.

```
$ vi (pwd)/values.yaml
```

* Please edit this:

1. values.yaml.oobeyaDashboard

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

2. values.yaml.oobeyaGateway

```
 - corsAllowedOrigin: "http://your-IP-or-Domain"
 - gatewayBaseOrigin: "http://your-IP-or-Domain"
```

### Installing Oobeya with Helm

```
$ helm lint .

$ helm install oobeya . --namespace oobeya
```