Setup Environment

This guide will walk you through setting up your development environment to make sure you have all the necessary tools to operate your Rollapp.

note

For production use, it is recommended to run Roller on a Linux operating system. While development and testing can be done on other platforms, Linux provides the most stable and supported environment for running Roller in a production setting.

Important

To install the necessary dependencies, you must have administrative (sudo) privileges on your system.

Install essentials

Before installing dependencies, ensure your system is up-to-date:

APT

sudo apt update && sudo apt upgrade -y

YUM

sudo yum update -y

macOS

brew update && brew upgrade

Then install essential packages:

APT

sudo apt install -y build-essential clang curl aria2 wget tar jq libssl-dev pkg-config make

YUM

sudo yum install -y clang openssl-devel make git

macOS

brew install curl aria2 wget jq openssl pkg-config make

Install Docker

APT (AMD64)

Setup the desired version of docker:

export DOCKER_API_VERSION=1.41

Setup docker repository:

# Add Docker's official GPG key:
sudo apt-get update
sudo apt-get install ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

# Add the repository to Apt sources:
echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu \
  $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt-get update

Install docker packages:

sudo apt-get -y install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

give permission to the current user to use the docker daemon:

sudo usermod -aG docker ${USER}

re-login to the user:

newgrp docker

YUM (AMD64)

Setup docker repository:

sudo yum install -y yum-utils
sudo yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo

Install docker packages:

sudo yum install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

Start docker:

sudo systemctl start docker

give permission to the current user to use the docker daemon:

sudo usermod -aG docker ${USER}

re-login the user:

newgrp docker

Install Go

ver="1.23.0"

Linux (AMD64)

cd $HOME
wget "https://golang.org/dl/go$ver.linux-amd64.tar.gz"
sudo rm -rf /usr/local/go
sudo tar -C /usr/local -xzf "go$ver.linux-amd64.tar.gz"
rm "go$ver.linux-amd64.tar.gz"

Linux (ARM64)

cd $HOME
wget "https://golang.org/dl/go$ver.linux-arm64.tar.gz"
sudo rm -rf /usr/local/go
sudo tar -C /usr/local -xzf "go$ver.linux-arm64.tar.gz"
rm "go$ver.linux-arm64.tar.gz"

macOS (Apple Silicon)

cd $HOME
wget "https://golang.org/dl/go$ver.darwin-arm64.tar.gz"
sudo rm -rf /usr/local/go
sudo tar -C /usr/local -xzf "go$ver.darwin-arm64.tar.gz"
rm "go$ver.darwin-arm64.tar.gz"

macOS (Intel)

cd $HOME
wget "https://golang.org/dl/go$ver.darwin-amd64.tar.gz"
sudo rm -rf /usr/local/go
sudo tar -C /usr/local -xzf "go$ver.darwin-amd64.tar.gz"
rm "go$ver.darwin-amd64.tar.gz"

Add Go to your PATH:

echo 'export GOPATH=$HOME/go' >> ~/.bashrc
echo 'export PATH=$PATH:/usr/local/go/bin:$GOPATH/bin' >> ~/.bashrc
source ~/.bashrc

Verify the installation:

go version

Install Roller

If you haven't already, install Roller:

curl https://raw.githubusercontent.com/dymensionxyz/roller/main/install.sh | bash

Verify the installation:

roller version

Next steps

Now that you have all required dependencies installed, you can proceed to choose which components of the Rollapp you want to operate.