Get GAXPRO
Setup

Installation: Go and Required Tools

Step-by-step guide to installing Go on Windows, macOS, and Linux, plus the tools needed to run GAX Pro.

Installation: Go and Required Tools

What You Need to Install

GAX Pro requires two things before you can build a site:

1. Go (version 1.21 or newer) — the runtime that builds the site

2. A terminal — already on every system, but the commands differ per OS

You do not need Node.js, npm, Python, Ruby, or a database. Go is the only build dependency.

Install Go on Windows

There are two ways to install Go on Windows.

1. Go to go.dev/dl and download the Windows installer (.msi) for the latest version.

2. Run the installer and follow the default prompts.

3. Go installs to C:\Program Files\Go and adds itself to your PATH automatically.

4. Open Command Prompt or PowerShell and check the installation:


go version

You should see something like go version go1.23.0 windows/amd64.

Option 2: Package Manager

If you use Chocolatey or Scoop, install Go from there:


choco install golang

or


scoop install go

Install Go on macOS

Option 1: Official Installer

1. Go to go.dev/dl and download the macOS installer (.pkg).

2. Run the installer and follow the default prompts.

3. Open Terminal and verify:


go version

Option 2: Homebrew

If you use Homebrew:


brew install go

Install Go on Linux

Option 1: Package Manager

For Debian or Ubuntu:


sudo apt update
sudo apt install golang-go

For Fedora:


sudo dnf install golang

For Arch:


sudo pacman -S go

Option 2: Official Binary

If your distribution does not have a recent Go version, download the official binary:


wget https://go.dev/dl/go1.23.0.linux-amd64.tar.gz
sudo tar -C /usr/local -xzf go1.23.0.linux-amd64.tar.gz

Then add Go to your PATH in ~/.bashrc or ~/.zshrc:


export PATH=$PATH:/usr/local/go/bin

Reload your shell and verify:


go version

Verify the Installation

After installing, open a terminal and run:


go version

You should see the version number. If you see command not found or not recognized, Go is not in your PATH — reinstall using the official installer or add it manually.

A Note on the Terminal

GAX Pro uses terminal commands for setup. The commands are the same on Windows, macOS, and Linux, with one difference: Windows uses cmd or PowerShell, while macOS and Linux use Terminal.

Examples in this documentation use bash syntax. On Windows Command Prompt, most commands work the same. On PowerShell, use the same commands unless noted otherwise.

Next Step

Go is installed. Now you need the GAX Pro source code:

If you have a license and the theme files, go to Run the Project.

Troubleshooting

go: command not found — Go is not in your PATH. Reinstall with the official installer, or add the Go binary directory to your PATH manually.

permission denied on Linux — use sudo for system-level installs, or install Go to your home directory instead.

Version too old — GAX Pro requires Go 1.21 or newer. Download the latest version from go.dev/dl.

Need Help?