---

name: structsd-install description: Installs the structsd binary from source. Covers Go, Ignite CLI, and building structsd for Linux and macOS. Use when structsd is not found, when setting up a new machine, or when the agent needs to install or update the Structs chain binary.

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

• structsd: command not found — Ensure ~/go/bin is on your PATH. Run ls ~/go/bin/structsd to confirm the binary exists.
• ignite: command not found — Re-run the Ignite CLI install. The curl command installs to /usr/local/bin/ignite.
• go: command not found — Ensure /usr/local/go/bin is on your PATH. Reload your shell profile.
• Build fails with Go version error — Verify go version shows 1.24.1+. Older Go versions are not compatible.
• Permission denied on /usr/local — Use sudo for the tar extraction. On shared systems, ask your administrator.

See Also

• TOOLS — Environment configuration (servers, account, after structsd is installed)
• structs-onboarding skill — Player creation and first builds (requires structsd)