Windows

Last updated: January 2026

This guide explains how to build Abey (gabey) from source on Windows using Chocolatey and Go.


Prerequisites

Before building Abey, ensure the following requirements are met:

  • Windows 10 or later

  • Administrator access

  • Chocolatey package manager

  • Go 1.15 or later

If Chocolatey is not installed, follow the instructions at:

  • https://chocolatey.org


Install Build Tools

Open an Administrator Command Prompt and install the required tools:

choco install git
choco install golang
choco install mingw

These installations will automatically update your PATH environment variable. After installation completes, open a new command prompt (non-administrator is fine).


Configure Go Environment

Ensure that the installed Go version is 1.15 or newer.

Set up the Go workspace and environment variables:

Important Note

If you see the warning below, the setx command may truncate your PATH variable:

If this occurs, stop immediately, clean up your PATH, and retry the setup to avoid breaking your environment.


Clone the Repository

Create the required directory structure and clone the Abey source code:


Resolve Go Dependencies (if needed)

Attempt to fetch required Go dependencies:

If the command above fails, manually install the dependency:


Build gabey

Compile the Abey binaries using:

This will build gabey and related tools into your Go bin directory.


Running the Node

After a successful build, you can run the Abey node by executing:

Ensure %GOPATH%\bin is included in your PATH.


Troubleshooting

  • Verify Go is correctly installed by running go version

  • Ensure GOPATH and PATH are set correctly

  • Reopen the command prompt after installing tools

  • Avoid truncating the Windows PATH variable

Last updated