Docker setup

This guide will help you set up and run a Masa Node using Docker ready for configuration and deployment.

​

Prerequisites

Before you begin, ensure you have the following installed:

• Docker
• Docker Compose
• Sepolia ETH (you will need 0.01 Sepolia ETH in your node’s wallet for the sepolia Masa faucet to function)

:::caution

You need to have 0.01 Sepolia ETH on hand to stake sepolia Masa with your node.

:::

​

Clone the repository

git clone https://github.com/masa-finance/masa-oracle.git

cd masa-oracle

​

Environment Configuration

Set up environment variables to connect your node to run your node in local bootnode configuration

Create a .env file in the root directory with these essential variables:

# Default .env configuration

RPC_URL=https://ethereum-sepolia.publicnode.com
ENV=test
FILE_PATH=.
VALIDATOR=false
PORT=8080
API_ENABLED=true

​

Building the Docker Image

With Docker and Docker Compose installed and your .env file configured, build the Docker image using the following command:

docker-compose build

This command builds the Docker image based on the instructions in the provided Dockerfile and docker-compose.yaml.

​

4. Start the node

docker-compose up

You will see the following output:

#######################################
#     __  __    _    ____    _        #
#    |  \/  |  / \  / ___|  / \       #
#    | |\/| | / _ \ \___ \ / _ \      #
#    | |  | |/ ___ \ ___) / ___ \     #
#    |_|  |_/_/   \_\____/_/   \_\    #
#                                     #
#######################################

Multiaddress:        /ip4/192.168.1.8/udp/4001/quic-v1/p2p/16Uiu2HAmDXWNV9RXVoRsbt9z7pFSsKS2KdpN7HHFVLdFZmS7iCvo
IP Address:          /ip4/127.0.0.1/udp/4001/quic-v1
Public Key:          0x5dA36a3eB07fd1624B054b99D6417DdF2904e826
Is Staked:           false
Is Validator:        false
Is TwitterScraper:   false
Is DiscordScraper:   false
Is TelegramScraper:  false

​

Masa Protocol Configuration

You can now configure your node to start scraping data as a miner, to fetch data from the network or to start participating in the network as a validator.

​

Configure your node

​

Stake your node

After starting the node, you must stake sepolia Masa tokens to participate in the network; the node comes with a faucet to get sepolia Masa tokens you need Sepolia ETH in your wallet to get Sepolia MASA tokens from the faucet.

​

Masa Protocol Configuration

You can now configure your node to start scraping data as a miner, to fetch data from the network or to start participating in the network as a validator.

​

Configure your node

​

Stake your node

After starting the node, you must stake sepolia Masa tokens to participate in the network; the node comes with a faucet to get sepolia Masa tokens you need Sepolia ETH in your wallet to get Sepolia MASA tokens from the faucet.

1. Get your node’s public key from the logs.

2. Send Sepolia ETH to your node’s public key address.

3. Run the make faucet command to get Sepolia MASA:

   docker-compose run --rm masa-node /usr/bin/masa-node --faucet
   

4. Run the make stake command to stake your node:

   docker-compose run --rm masa-node /usr/bin/masa-node --stake 1000
   

5. Run the container in detached mode:

   docker-compose up -d
   

6. Check the logs to verify the node is running properly:

   docker-compose logs -f masa-node
   

​

Accessing Your Node Keys

The node generates keys that are stored in the /home/masa/.masa/ inside the Docker container, ensuring that your keys are safely stored on your host machine.

1. Open a shell inside the container:

   docker-compose exec masa-node /bin/sh
   

2. Navigate to the keys directory:

   cd /home/masa/.masa/
   

3. List the keys:

   ls -la
   

4. Copy the keys to your host machine:

   cp -r /home/masa/.masa/ /path/to/your/host/machine/
   

​

Custom configuration

You can customize your node’s configuration by modifying the .env file inside the Docker container. Follow these steps to make changes:

1. SSH into the running container:

   docker-compose exec masa-node /bin/sh
   

2. Navigate to the directory containing the .env file:

   cd /home/masa
   

3. Edit the .env file using a text editor like nano or vi:

   nano .env
   

4. Make your desired changes to the .env file. You can modify existing variables or add new ones as needed.

5. Save the changes and exit the text editor.

6. Exit the container:

   exit
   

7. Restart the container to apply the changes:

   docker-compose down
   docker-compose up -d
   

After following these steps, your node will restart with the updated configuration from the modified .env file.

​

Configure a Twitter Scraper

To set up your node as a Twitter scraper, you need to add a twitter_cookies.json file to the container. For more information on obtaining Twitter cookies refer to our Twitter Scraper Configuration Guide.

Follow these steps:

1. Prepare your twitter_cookies.json file on your local machine.

2. Copy the file into the running container:

   docker cp /path/to/your/twitter_cookies.json masa-node:/home/masa/.masa/twitter_cookies.json
   

3. SSH into the running container:

   docker-compose exec masa-node /bin/sh
   

4. Verify the file has been copied correctly:

   ls -l /home/masa/.masa/twitter_cookies.json
   

5. Ensure the file has the correct permissions:

   chmod 600 /home/masa/.masa/twitter_cookies.json
   

6. Exit the container:

   exit
   

7. Modify your .env file to enable Twitter scraping:

   docker-compose exec masa-node /bin/sh -c "echo 'TWITTER_SCRAPER=true' >> /home/masa/.env"
   

8. Restart the container to apply the changes:

   docker-compose down
   docker-compose up -d
   

9. Your node should now be configured as a Twitter scraper. You can verify this by checking the logs:

   docker-compose logs -f masa-node
   

10. Look for a line indicating that the Twitter scraper is active:

    Is TwitterScraper:   true
    

:::warning Ensure that your twitter_cookies.json file contains valid Twitter credentials. Using invalid or expired credentials may result in the scraper failing to function properly. :::