Install structsd

Builds the structsd binary from source using Ignite CLI. After this procedure, structsd will be available on your PATH.

Prerequisites

Two dependencies are required: Go 1.24.1+ and Ignite CLI.


1. Install Go

Linux (amd64)

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

If an older Go was installed via apt, remove it first: sudo apt remove -y golang-go

macOS (Apple Silicon)

curl -OL https://go.dev/dl/go1.24.1.darwin-arm64.tar.gz
sudo rm -rf /usr/local/go
sudo tar -C /usr/local -xzf go1.24.1.darwin-arm64.tar.gz
rm go1.24.1.darwin-arm64.tar.gz

macOS (Intel)

curl -OL https://go.dev/dl/go1.24.1.darwin-amd64.tar.gz
sudo rm -rf /usr/local/go
sudo tar -C /usr/local -xzf go1.24.1.darwin-amd64.tar.gz
rm go1.24.1.darwin-amd64.tar.gz

Alternatively on macOS: brew install go@1.24

Configure PATH

Add to ~/.profile (or ~/.zshrc on macOS):

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

Reload: source ~/.profile (or source ~/.zshrc)

Verify

go version

Expected: go version go1.24.1 linux/amd64 (or darwin/arm64, etc.)


2. Install Ignite CLI

curl https://get.ignite.com/cli! | bash

Verify

ignite version

3. Build structsd

Clone the repository and build:

git clone https://github.com/playstructs/structsd.git
cd structsd
ignite chain build

The binary is installed to ~/go/bin/structsd. Since ~/go/bin is on your PATH (from step 1), it’s immediately available.

Verify

structsd version

4. Update structsd

To update to the latest version:

cd structsd
git pull origin main
ignite chain build

Quick Check

Run all verifications in sequence:

go version && ignite version && structsd version

If any command fails, revisit the corresponding step above.

Troubleshooting

See Also