Install Rubix

To install and run a Rubix node, you will need the following components:

• rubixgoplatform: Rubix node executable binary
• Docker: Required to run the PostgreSQL backend used by the node

note

The v1.0.1 release download below contains only the rubixgoplatform executable (plus README and license). You also need, obtained separately:

• IPFS: compatible version v0.19.0 (IPFS Kubo v0.19.0).
• swarm.key and testnetswarm.key: from the Rubix repo: swarm.key and testnetswarm.key.

Docker is installed separately (see below).

📦 Download the Rubix node executable below

Linux

Linux Installation

Select your system architecture:

• ARM 64:
  📦 Download ARM Bundle (.tar.gz)
• AMD 64:
  📦 Download AMD Bundle (.tar.gz)

Installation Steps:

1. Extract the contents to the directory where you want to run the Rubix node using tar -xzf
2. Make binaries executable: chmod +x rubixgoplatform ipfs
3. Verify installation: ./rubixgoplatform -v (this will display the installed version)

Windows

Windows Installation

Download the Windows bundle:

📦 Download Full Windows Bundle (.zip)

Installation Steps:

1. Extract the .zip contents to the directory where you want to run the Rubix node.
2. Verify installation: ./rubixgoplatform.exe -v (this will display the installed version)

macOS

macOS Installation

Select your system architecture:

• ARM (Apple Silicon):
  📦 Download ARM Bundle (.tar.gz)
• AMD (Intel):
  📦 Download AMD Bundle (.tar.gz)

Installation Steps:

1. Extract the contents to the directory where you want to run the Rubix node using tar -xzf
2. Make binaries executable: chmod +x rubixgoplatform ipfs
3. Verify installation: ./rubixgoplatform -v (this will display the installed version)

You can also refer Rubix Releases.

System Requirements

• Memory: Minimum 4GB RAM (8GB recommended)
• Storage: At least 10GB available disk space
• Docker: Required (used to run PostgreSQL)
• Operating System:
  • Windows 10 or later (64-bit)
  • macOS 10.15 or later
  • Linux (Ubuntu 18.04+, CentOS 7+, etc.)

Install Docker

Rubix uses PostgreSQL as its database backend, and PostgreSQL runs inside a Docker container. Install Docker before proceeding.

Linux (Ubuntu/Debian):

sudo apt update
sudo apt install docker.io
sudo systemctl enable --now docker

macOS:

Install Docker Desktop for Mac.

Windows:

Install Docker Desktop for Windows.

Verify your installation:

docker --version

The PostgreSQL container itself is launched as part of the node startup flow. See Run Rubix Locally for the exact command.

Once you have successfully installed Rubix and Docker, you can proceed to start a Rubix Node.

For additional help, visit our support page or check the GitHub issues.