# 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 & Running](/master-nodes/run-a-node/gui-installing-and-running.md) 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.


---

# 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.playa3ull.games/master-nodes/run-a-node/docker-installing-and-running.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.