Take part in creating the future of blockchain.

A tool to help code, build, test and deploy smart contracts and decentralized applications. At the base, the DevKit is a UNIX friendly command-line tool.

Gitlab Icon Get your DevKit

DevKit installation instructions

The DevKit runs on Linux, Mac OSX and on Windows 10. For installing on Windows 10 see instructions further down.
After installing the Devkit watch this video to see how to create your first DApp.

Upgrading an existing installation

Be sure you are running the latest version of the Devkit, we are pushing new releases many times a week.

space -U web3-sh/devkit

If the Devkit got updated then the next time you start it Docker will download the new image automatically.

Installing on Mac OSX and Gnu/Linux

The Superblocks DevKit runs in a Docker container and is managed by a Space module.

1. Install Docker

If you do not have Docker installed already visit https://www.docker.com/community-edition#download and download the Docker Community edition (CE) for your platform.

2. Install Space.sh

Install Space.sh (version 1.1.0 or later). For details see: https://space.sh.

On the command line, enter:

curl -s https://get.space.sh | sudo sh

3. Install and run the DevKit

When issuing the Space command below for the first time the DevKit module will be downloaded and run, this will also download the Docker image, which will take some time to complete.

space -m web3-sh/devkit /run/

When running the DevKit will output `Geth` logs into the console.

A web server (`nginx`) will run in the background. Access it by browsing to `http://127.0.0.1`, `http://localhost` or try the Docker Machine default: `http://192.168.99.100`.

In case port `80` is already taken, it is possible to customize it by starting the DevKit as:

space -m web3-sh/devkit /run/ -e port=8080

For more information, please refer to the README file located in the project repository.

Installing on Windows 10

Space.sh requires Bash version 3.2 or later under a GNU/Linux environment or equivalent. It is possible to setup such an environment under Windows 10 by taking advantage of Windows Subsystem for Linux (WSL).

1. Enable Microsoft Windows Subsystem for Linux (WSL)

Run Windows PowerShell as administrator and enter the following command:

Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux

Wait for the command line to complete. It will ask for a restart. Answer "Y"

2. Install Ubuntu

1. Visit: http://aka.ms/wslstore and choose Ubuntu distribution

2. Open the command prompt and type in:

ubuntu

and wait for installation to succeed.

3. After installation has finished, it will prompt for an account name and password. Commands `bash` and `ubuntu` will be available from there on via the Windows command prompt.

3. Install Space.sh

1. Enter Ubuntu bash for Windows

2. Install Space.sh in Ubuntu:

curl -s https://get.space.sh | sudo sh

4. Install Docker Toolbox (for Windows 10 Home edition or CPUs without HyperV)

Regular Docker can be downloaded from https://www.docker.com.

For Windows Home edition and other targets that do not support HyperV, use Docker Toolbox: https://download.docker.com/win/stable/DockerToolbox.exe

1. Enter Ubuntu bash for Windows subsystem for Linux by typing in `bash` in the command prompt

2. Install Docker client in Ubuntu:

sudo apt update
sudo apt install docker.io

3. Configuration depends on host Docker environment settings. On Windows prompt call:

docker-machine env default

4. Copy the output adjusting to shell export:

export DOCKER_TLS_VERIFY=1
export DOCKER_HOST=tcp://192.168.99.100:2376
export DOCKER_CERT_PATH=/mnt/c/Users//.docker/machine/certs

Docker commands are expected to work from here on. Configuring firewall settings for Docker

In order to configure open ports, it is necessary to run Windows Defender Firewall. Right click `Inbound Rules` and add a new rule. Select `port`, TCP and specific port set to `80` (or other of choice). Proceed until the name section and hit Finish. For Docker Toolbox, configure the VM accordingly. In Virtual Box, under `Settings/Network/Adapter`, add a new rule in the `Port Forwarding Rules` panel.

5. Install and run the DevKit

When issuing the Space command below for the first time the DevKit module will be downloaded and run, this will also download the Docker image, which will take some time to complete.

space -m web3-sh/devkit /run/

When running the DevKit will output `Geth` logs into the console.

A web server (`nginx`) will run in the background. Access it by browsing to `http://127.0.0.1`, `http://localhost` or try the Docker Machine default: `http://192.168.99.100`.

In case port `80` is already taken, it is possible to customize it by starting the DevKit as (you might need to update the firewall setting above too):

space -m web3-sh/devkit /run/ -e port=8080

For more information, please refer to the README file located in the project repository.

On the command line, enter:

space -m web3-sh/devkit /run/

This will output some information in the console. A web server (`nginx`) will run in the background. Access it by browsing to `http://127.0.0.1`, where `127.0.0.1` is the _Docker IP address_. _Hint: if you are not sure what the IP is, try the Docker Machine default: `192.168.99.100`_ In case port `80` is already taken, it is possible to customize it by doing:

space -m web3-sh/devkit /run/ -e port=8080

For more information, please refer to the README file located in the project repository.

Build your thing.