Massa Docker

Docker image for running a Massa node with precompiled binaries.

Overview

This Docker image builds a containerized Massa blockchain node based on Ubuntu 24.04 with precompiled binaries from the official Massa releases.

Architecture

• Base Image: ubuntu:24.04
• Massa Version: MAIN.4.1
• Node Binary: Precompiled from GitHub releases

Build Requirements

The build context must include the following files/directories:

.
├── Dockerfile
├── start_massa.sh
├── massa-node/
│   └── config/          # Massa node configuration files
└── massa-client/        # (Optional) Massa client files

Building the Image

docker build -t massa-node:latest .

Running the Container

docker run -d \
  --name massa-node \
  -p 31244:31244 \
  -p 31245:31245 \
  -p 33034:33034 \
  -p 3001:3001 \
  massa-node:latest

Exposed Ports

Port	Purpose
31244	P2P protocol port
31245	Secondary P2P port
33034	API/RPC endpoint
3001	Application port

Configuration

Node Configuration

Place your Massa node configuration in massa-node/config/ before building. This directory is copied into the container at /massa/massa-node/config/.

Node Password

Modify start_massa.sh to change the node password if needed.

Logs

Node logs are written to /massa/massa-node/logs.txt inside the container. Access them with:

docker logs -f massa-node

Dependencies

Installed in the image:

• curl - For downloading binaries
• libssl-dev - SSL/TLS libraries for cryptographic operations

Unused dependencies are removed to minimize image size.

Startup Script

The container automatically starts the Massa node using start_massa.sh:

1. Navigates to the massa-node directory
2. Launches the Massa node binary with the specified key
3. Logs output to logs.txt
4. Keeps the container running indefinitely