Installation

The Operator Service can be installed in several ways: as a binary, via Docker, or built from source. Choose your preferred method and follow the instructions below.

Binary

1. Go to the releases page ↗ and find version v3.1.10
2. Select the binary file for your node's hardware
3. Download and decompress the file

To install, run:

curl -sSfL https://raw.githubusercontent.com/stakewise/v3-operator/v3.1.10/scripts/install.sh | sh -s

The binary will be placed in ~/bin. Add it to your PATH:

export PATH=$PATH:~/bin

Run commands from inside the v3-operator folder using this format:

./operator COMMAND --flagA=123 --flagB=xyz

Docker Image

Pull Official Image

docker pull europe-west4-docker.pkg.dev/stakewiselabs/public/v3-operator:v3.1.10

Alternatively, build the Docker image locally:

git clone https://github.com/stakewise/v3-operator.git
cd v3-operator
git checkout v3.1.10
docker build --pull -t europe-west4-docker.pkg.dev/stakewiselabs/public/v3-operator:v3.1.10 .

Run commands using this format:

docker run --rm -ti \
-u $(id -u):$(id -g) \
-v ~/.stakewise/:/data \
europe-west4-docker.pkg.dev/stakewiselabs/public/v3-operator:v3.1.10 \
src/main.py COMMAND \
--flagA=123 \
--flagB=xyz

Docker Data Directories

You must set --data-dir=/data and map it to a host directory. The --database-dir should also be mapped to a host directory or Docker volume with write permissions enabled. Permissions setup is not required when using Docker volumes.

Source Files

Requirements:

• Python 3.10+ ↗
• Poetry ↗

Run the setup command:

git clone https://github.com/stakewise/v3-operator.git
cd v3-operator
git checkout v3.1.10
poetry install --only main

Run commands from inside the v3-operator folder using this format:

PYTHONPATH=. poetry run python src/main.py COMMAND --flagA=123 --flagB=xyz

Next Steps

Once installed, continue with Prepare Operator →.