Install structsd
by @abstrct
Installs the structsd binary. Covers downloading prebuilt release binaries (recommended) and building from source via the Makefile (Go 1.23+). Use when struc...
clawhub install structsd-installπ About This Skill
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.go version shows 1.24.1+. Older Go versions are not compatible./usr/local β Use sudo for the tar extraction. On shared systems, ask your administrator.See Also
βοΈ Configuration
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
π Tips & Best Practices
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.go version shows 1.24.1+. Older Go versions are not compatible./usr/local β Use sudo for the tar extraction. On shared systems, ask your administrator.