# Docker: Installing & Running

{% hint style="warning" %}
**Advanced Users Only**

Installing and running the Master Node CLI is for advanced users only. If you do not know what you are doing, please follow the [gui-installing-and-running](https://docs.playa3ull.games/master-nodes/run-a-node/gui-installing-and-running "mention") tutorial instead.
{% endhint %}

## Prerequisites

* Docker Engine ≥ 24.0
* Master Node License Key (only necessary if running headless)

## 1. Pull latest image

Pull the latest Docker image by running the following in your terminal:

```bash
docker pull ghcr.io/playa3ull/node
```

## 2. Run image

Now that you have pulled the latest Docker image, run the image by:

```bash
docker run ghcr.io/playa3ull/node
```

You will be prompted to login by authenticating your account via the dApp, which upon signing will automatically login the Master Node CLI to your account.

Once authenticated, you will be logged in and connected to the network!

Keep the software logged in and running in order to be eligible for rewards.

### 2.1 Optional Arguments

If you are running the Mater Node CLI on a machine/environment with interactivity, you can include the `-it` flag to interact with the built-in menu features.

```bash
docker run -it ghcr.io/playa3ull/node
```

### 2.2 Headless

In headless environments, you can authenticate with your Master Node by using it's associated license key, available via the [Account page on the dApp](https://app.playa3ull.games/account).

#### Passing as argument flag

The Master Node CLI can be ran with an optional license key argument flag to authenticate the service with the linked Master Node as:

```bash
docker run ghcr.io/playa3ull/node --license=your-license-key
```

#### Passing as environment variable

You can pass the license key through to the Master Node CLI via an environment variable when running the application:

```bash
docker run -e LICENSE_KEY=your-license-key ghcr.io/playa3ull/node
```

## Interface Flicker

Whilst running the Master Node CLI, you may notice flickering occurring. This is due to how the CLI interface is updated to show your uptime, new activity logs, etc.

This is something we will continue to improve, and aim to have completely fixed by the full release of the software.

In the interim, you can customize the refresh rate of the CLI via the `TERMINAL_REFRESH_RATE` environment variable, which dictates the refresh rate of the CLI in milliseconds.

```bash
docker run -e TERMINAL_REFRESH_RATE=30000 ghcr.io/playa3ull/node
```

The above command will refresh the terminal every 30 seconds.

## Troubleshooting Logs

{% hint style="info" %}
Logs help us find the root cause of the issue you encountered faster, always remember to submit a log file with your reports.
{% endhint %}

Logs can be found via the container file system at `tmp/PLAYA3ULL GAMES/node/logs`. Please supply a log file when submitting a report.