> For the complete documentation index, see [llms.txt](https://taraxa.gitbook.io/taraxa-network/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://taraxa.gitbook.io/taraxa-network/node-setup/testnet_node_setup-1/mac.md).

# Mac

Guide for running the Taraxa Node with Docker on Mac

{% hint style="info" %}
These instructions are specific to Mac. Instructions are also available for [Windows](broken://pages/-MYp9ZMDepU1JWUVcovE) and [Linux](broken://pages/-MYp9ZMETDZ5nHxoeZSg).
{% endhint %}

## 1. Download Docker Desktop

You can download Docker Desktop by accessing [this link for Intel Macs](https://desktop.docker.com/mac/stable/amd64/Docker.dmg) or [this link for Apple chip Macs](https://desktop.docker.com/mac/stable/arm64/Docker.dmg).

![Download Docker Desktop](https://902105633-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MJepYMaCjWn_0Y0r41o%2Fuploads%2Fgit-blob-19289044e393997e95d8718ed307d620034c9dc0%2F1-download.png?alt=media)

After the download finishes you can find the dmg file in the `Downloads` directory on the Dock.

![Downloaded Docker Desktop](https://902105633-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MJepYMaCjWn_0Y0r41o%2Fuploads%2Fgit-blob-3c8d77bb339a8f1ed212fcb026dd23ca1fba211d%2F2-downloaded.png?alt=media)

Open the `Docker.dmg` file.

![Open Docker Desktop](https://902105633-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MJepYMaCjWn_0Y0r41o%2Fuploads%2Fgit-blob-99e95857c2fd01a2ad7f77b9517958d6dce6c722%2F3-open.png?alt=media)

You should see a window similar to the following. Drag and drop the Docker app file into the Applications folder.

![Install Docker Desktop](https://902105633-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MJepYMaCjWn_0Y0r41o%2Fuploads%2Fgit-blob-0240e0afb9e6e4fc1c375fd0cfb346f051d4f20b%2F4-install.png?alt=media)

You may get a notice like this because the app was downloaded from the web and not installed from the App Store. You can safely click "Open" here.

![Confirm Docker Desktop](https://902105633-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MJepYMaCjWn_0Y0r41o%2Fuploads%2Fgit-blob-a80d4541de7b9f23111a88f2efe9ee3e89a127c8%2F5-allow.png?alt=media)

Docker also needs some privileges to install the Docker Helper. Click "OK" and enter your password.

![Confirm Docker Desktop](https://902105633-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MJepYMaCjWn_0Y0r41o%2Fuploads%2Fgit-blob-ed25e0f3033ab5c1c42b32995e01f91154f53d29%2F6-access.png?alt=media)

Now you can open Finder and go to the Applications folder. You should see the Docker app.

*NOTE: You can also press `CMD` + `SPACE` and search for Docker*

![Open Docker](https://902105633-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MJepYMaCjWn_0Y0r41o%2Fuploads%2Fgit-blob-184e4db6e72e6ec5d6862fa8f4ba4d76873b3d56%2F8-docker.png?alt=media)

After opening the application you should see a screen similar to this:

![Starting Docker](https://902105633-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MJepYMaCjWn_0Y0r41o%2Fuploads%2Fgit-blob-f44eff8b50e2596b8b6760f925a51178cacf2b40%2F9-starting.png?alt=media)

When Docker starts you should see this screen. We can close the Docker window now.

![Docker Started](https://902105633-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MJepYMaCjWn_0Y0r41o%2Fuploads%2Fgit-blob-82f4f42afae62c647d0cef9d7e9a285e718f42fe%2F10-started.png?alt=media)

## 2. Open Terminal

We need to use the `Terminal` application in order to start the Taraxa Node image.

You can find the app in the `Utilities` directory under `Applications`.

![Open Utilities](https://902105633-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MJepYMaCjWn_0Y0r41o%2Fuploads%2Fgit-blob-6e6cedbafe5af80faffa7c396ae0ee8b5228dcc3%2F11-utilities.png?alt=media)

Open the terminal application.

*NOTE: You can also press `CMD` + `SPACE` and search for Terminal*

![Open Terminal](https://902105633-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MJepYMaCjWn_0Y0r41o%2Fuploads%2Fgit-blob-2690a9c113727e780fa5f6f671005f89f1dabb6b%2F12-terminal.png?alt=media)

You should see a window similar to this:

![Terminal Open](https://902105633-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MJepYMaCjWn_0Y0r41o%2Fuploads%2Fgit-blob-a94f101c3722f55ae9fd2c9812978f0c3be70857%2F13-terminal-open.png?alt=media)

## 3. Start Taraxa

We have to run the following commands one by one:

```bash
cd ~/Desktop
curl -L https://github.com/Taraxa-project/taraxa-ops/archive/refs/heads/master.zip > master.zip && unzip master.zip && rm -f master.zip
```

{% hint style="danger" %}
GitHub is blocked in some countries. If you can't run the previous command please refer to the [GitHub is blocked](https://docs.taraxa.io/node-setup/testnet_node_setup/github_blocked) document.
{% endhint %}

```bash
cd ~/Desktop/taraxa-ops-master/taraxa_compose
docker-compose up -d
docker-compose logs -f
```

Now Docker is pulling the Taraxa Node image. You should see something similar to this:

![Starting Taraxa](https://902105633-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MJepYMaCjWn_0Y0r41o%2Fuploads%2Fgit-blob-f3fb577bc2e157fe233dce31942e11be177fc050%2F14-starting.png?alt=media)

After it finishes pulling the latest version the node will start and you should see something similar to the following:

![Taraxa Started](https://902105633-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MJepYMaCjWn_0Y0r41o%2Fuploads%2Fgit-blob-55592030c2ab0d7f57321ca727d22eb0b25f7e52%2F15-started.png?alt=media)

\*\*NOTE: \*\**You can press* `CTRL` + `C` *to stop displaying the logs*

## 4. Updating the Taraxa Node

From time to time we will release new versions of the node software. Try to keep it up to date using the following commands:

```bash
cd ~/Desktop/taraxa-ops-master/taraxa_compose
curl -0 https://raw.githubusercontent.com/Taraxa-project/taraxa-ops/master/taraxa_compose/docker-compose.yml > docker-compose-new.yml && mv docker-compose-new.yml docker-compose.yml
```

{% hint style="danger" %}
GitHub is blocked in some countries. If you can't run the previous command please refer to the [GitHub is blocked](https://github.com/Taraxa-project/taraxa-documentation/tree/f4ee57d43b23f5ad4a2212fa5ec90254d9181f92/node-setup/testnet_node_setup/node-setup/github_blocked.md) document.
{% endhint %}

```bash
docker-compose down
docker-compose pull
docker-compose up -d
docker-compose logs -f
```

During the testing period, we will also make changes on the protocol level and you will have to re-sync all the data. Don't worry, we will let you know. To remove the current data and do a full re-sync you have to run the following commands:

```bash
cd ~/Desktop/taraxa-ops-master/taraxa_compose
docker-compose down -v
docker-compose pull
docker-compose up -d
docker-compose logs -f
```