mirror of
https://github.com/mulgadc/spinifex.git
synced 2026-10-15 09:01:31 +00:00
Ben Duncan
48012a4058
- Rename .claude/rules/hive.md → spinifex.md - Update CLAUDE.md component description - Rename doc directories: hive-admin-cli → spinifex-admin-cli, etc. - Rename doc files: hive-cluster-stats, hive-code-consolidation, etc. - Bulk update all markdown files across docs/ tree - Update internal docs: CLUSTER-INSTALL, TESTING, DEVNOTES, BRANCHES
title, description, category, tags, badge, resources
| title | description | category | tags | badge | resources | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Spinifex Admin CLI | Complete reference for the Spinifex administration CLI. Manage accounts, nodes, VMs, and services. | Administration |
|
cli |
|
Spinifex Admin CLI
Complete reference for the Spinifex administration CLI.
Table of Contents
Overview
The spx binary is the central administration tool for managing your Spinifex infrastructure. It provides commands for cluster initialization, account management, node operations, VM lifecycle, and service control.
Binary location: ~/Development/mulga/spinifex/bin/spx
All services in the Spinifex platform are managed through this single binary.
Instructions
Account Management
./bin/spx admin account create --name myteam
export AWS_PROFILE=spinifex-myteam
Node Management
./bin/spx get nodes
NAME STATUS IP REGION AZ UPTIME VMs
node1 Ready 127.0.0.1 ap-southeast-2 ap-southeast-2a 2m 0
node2 Ready 127.0.0.2 ap-southeast-2 ap-southeast-2a 2m 0
node3 Ready 127.0.0.3 ap-southeast-2 ap-southeast-2a 2m 0
Monitor Resources
./bin/spx top nodes
Image Management
./bin/spx admin images list
./bin/spx admin images import --name debian-12-arm64
Cluster Shutdown
./bin/spx admin cluster shutdown
Troubleshooting
Permission denied running hive
The binary may not be executable. Fix permissions:
chmod +x ./bin/spx
If you get permission errors during operations, ensure you're running with appropriate privileges. Some OVN and networking commands require sudo.
Services fail to start
Check the daemon logs for specific errors:
ls ~/spinifex/logs/
cat ~/spinifex/logs/daemon.log
Common causes include port conflicts, missing OVN configuration, or untrusted CA certificates.