| 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)
