Taraxa Project
WebsiteExplorerCommunity Site
  • 👋Welcome!
  • 💵Wallet
    • Metamask
    • Ledger
    • Taraxa's Network Connection Details
  • 🌱Become a Validator
    • ⚙️Set up validator node
    • 🖥️Consensus node hardware requirements
    • 🚩Register node via community site
    • ⛓️Register node directly on-chain
    • 📣Solicit delegation
    • 🛠️Node upgrade & reset
  • 💰Staking
    • 💧Liquid Staking
    • 🚩Staking via community site
    • ⛓️Staking directly on-chain
  • 🌉Ficus Root Bridge
    • ↔️Bridge usage guide
    • 📜On-chain contracts
    • 🔎Audit Report
  • 💥Taraxa Grant Program
  • Develop on Taraxa
    • 🚀Start building on Taraxa!
    • 🔗Connecting to Taraxa
    • 📓Smart Contracts
      • Remix
    • ⚒️Common frameworks & Examples
    • 💧Testnet faucet
    • 🔩Taraxa RPC Specs
  • Node Operations
    • ⚙️Deploy A Node
      • Digital Ocean
      • AWS
      • Alibaba Cloud
      • Scaleway
      • Vultr
      • Linode
      • Azure
      • Hetzner
      • GitHub is blocked
    • 🪶Lite Consensus Node (beta)
    • ⏺️Upgrade a Node
      • ⬆️Upgrade Node
      • 🔁Reset Node
    • 🔀Syncing From Snapshot
    • 📬Node's Public Address
    • 🗝️Node's VRF Key
    • 📒Node Proof of Ownership
    • ❓Node Operations FAQ
    • 🔢Node Release Notes
    • ⚙️Install A Local Node
      • Windows
      • Mac
      • Linux
      • Digital Ocean
      • AWS
      • Alibaba Cloud
      • Scaleway
      • Vultr
      • Linode
      • Azure
      • Hetzner
      • GitHub is blocked
  • FAQ
    • 1️Layer-1 Tech
    • 🪙TARA Token
    • 🌱Mainnet
    • 🔁Exchange Integration
  • Whitepaper
    • Abstract
    • Intro: Scaling the World
    • Taraxa Architecture
    • Economic Model
    • Governance
    • Further Reading
  • NATIVE TOKEN CONVERSION
    • 💡Introduction
    • 🗓️Conversion Status
    • ❓Conversion FAQ
    • ⚗️Mock Conversion
    • 📋Exchange Submission
  • Governance
    • ℹ️Introduction
    • ⚡Voting Guide
Powered by GitBook
On this page
  • 1. Download Docker Desktop
  • 2. Open Terminal
  • 3. Start Taraxa
  • 4. Updating the Taraxa Node

Was this helpful?

  1. Node Operations
  2. Install A Local Node

Mac

Guide for running the Taraxa Node with Docker on Mac

PreviousWindowsNextLinux

Last updated 3 years ago

Was this helpful?

These instructions are specific to Mac. Instructions are also available for Windows and Linux.

1. Download Docker Desktop

You can download Docker Desktop by accessing or .

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

Open the Docker.dmg file.

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

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.

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

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

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

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

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 the terminal application.

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

You should see a window similar to this:

3. Start Taraxa

We have to run the following commands one by one:

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
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:

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

**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:

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
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:

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

GitHub is blocked in some countries. If you can't run the previous command please refer to the document.

GitHub is blocked in some countries. If you can't run the previous command please refer to the document.

⚙️
GitHub is blocked
GitHub is blocked
this link for Intel Macs
this link for Apple chip Macs
Download Docker Desktop
Downloaded Docker Desktop
Open Docker Desktop
Install Docker Desktop
Confirm Docker Desktop
Confirm Docker Desktop
Open Docker
Starting Docker
Docker Started
Open Utilities
Open Terminal
Terminal Open
Starting Taraxa
Taraxa Started