First, you need to install Go if it is not already installed on your machine. It is recommended that you use the most recent version of Go.
- gcc: Some packages in this repo might require to be compiled by gcc. Windows users can install MinGW-gcc.
If you need to develop locally and be able to build by using your local code, i.e., without waiting for pushing your commits on the repo, clone the repository directly inside the
src/github.com/iotaledger/ folder of your
$GOPATH with the command:
git clone firstname.lastname@example.org:iotaledger/goshimmer.git
or if you prefer https over ssh
git clone https://github.com/iotaledger/goshimmer.git
Verify that you have installed the minimal required go version (1.12.7):
You can build your executable (as well as cross compiling for other architectures) by running the
go build tool inside the just cloned folder
go build -o shimmer
ren shimmer shimmer.exe
You can then run by:
To run Shimmer on docker, you must first build the image with
docker build -t iotaledger/goshimmer .
and then run it with
docker run --rm -it -v "$(pwd)/mainnetdb:/app/mainnetdb" iotaledger/goshimmer
You may replace
$(pwd)/mainnetdb with a custom path to the database folder.
To start Shimmer in the background, you can also simply use Docker Compose by running
docker-compose up -d