# Docker Compose

### Local DNS entries

Update the /etc/hosts file adding the following entries:

```bash
127.0.0.1 terrakube-api
127.0.0.1 terrakube-ui
127.0.0.1 terrakube-executor
127.0.0.1 terrakube-dex
127.0.0.1 terrakube-registry
```

### Running Terrakube Locally.

```bash
git clone https://github.com/AzBuilder/terrakube.git
cd terrakube/docker-compose
docker-compose up -d
```

Terrakube will be available in the following URL:

* <http://terrakube-ui:3000>
  * Username: <admin@example.com>
  * Password: admin

### Docker Compose with Open Telemetry Setup

You can also test Terrakube using the Open Telemetry example setup to see how the components are working internally and check some internal logs

```
git clone https://github.com/AzBuilder/terrakube.git
cd terrakube/telemetry-compose
docker-compose up -d
```

{% hint style="info" %}
The setup is using jaegertracing/all-in-one

Jaeger UI will be available in <http://localhost:16686/>
{% endhint %}

<figure><img src="https://2695156030-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiAistJ55LNNLsrfZftuX%2Fuploads%2Fgit-blob-74d6154ee6d105ce640e01af36e3f17397973c13%2Fimage%20(110).png?alt=media" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2695156030-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiAistJ55LNNLsrfZftuX%2Fuploads%2Fgit-blob-cb692d4b9408a1300312c601b47183fb5b3dea51%2Fimage%20(34).png?alt=media" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
For more information about Open Telemetry setup check the [following information](https://docs.terrakube.io/2.20.0/getting-started/deployment/open-telemetry)
{% endhint %}