Start Building on Spinifex
Find instructions and examples to run AWS-compatible workloads on your own bare-metal infrastructure.
Install Spinifex on Linux
Get started with Spinifex infrastructure in a few simple steps.
# Install Spinifex
$curl -fsSL https://install.mulgadc.com | bash
# Setup OVN networking
$sudo /usr/local/share/spinifex/setup-ovn.sh --management
# Initialize cluster
$sudo spx admin init --node node1 --nodes 1
# Start services
$sudo systemctl start spinifex.target
# Verify installation
$export AWS_PROFILE=spinifex
$aws ec2 describe-instance-types
Spinifex initialized successfully.
Deploy a Multi-Node Availability Zone
Create a local AWS region and availability zone on your own hardware.
First Time Here?
Try these developer quickstarts.
Install Spinifex on a single server using the binary installer.
Deploy Spinifex across multiple servers to create an availability zone with high availability, data durability, and fault tolerance.
Migrate existing AWS workloads to Spinifex using compatible APIs, SDKs, and Terraform.
Spinifex Support
Access documentation, software, and expert assistance for your Spinifex deployment.
What's New
New and recently updated playbooks.
Install Spinifex on a single server using the binary installer.
Deploy Spinifex across multiple servers to create an availability zone with high availability, data durability, and fault tolerance.
Build Spinifex from source for development, custom builds, or contributing.
All Playbooks
Instructions to set up and configure workloads on Spinifex.
Install
Install Spinifex on a single server using the binary installer.
Deploy Spinifex across multiple servers to create an availability zone with high availability, data durability, and fault tolerance.
Build Spinifex from source for development, custom builds, or contributing.
Deploy Spinifex in environments without internet connectivity. Covers using a pre-built release tarball, mirrored APT packages, and locally-staged cloud images.
Install Spinifex on bare-metal hardware by flashing the Spinifex ISO to a USB drive and booting the target device from it.
Admin
Import an AMI, create a VPC with a public subnet, and launch your first EC2 instance on Spinifex.
Complete reference for the Spinifex administration CLI. Manage accounts, nodes, VMs, and services.
Upgrade an existing Spinifex installation to the latest release.
Compute
How Spinifex implements AWS-compatible VPC networking with public and private subnets, security groups, and Elastic IPs using OVN.
Launch, manage, and connect to EC2-compatible virtual machines on Spinifex.
Create and manage spread and cluster placement groups for hardware-level instance placement control.
Configure VFIO GPU passthrough on a Spinifex node to expose NVIDIA or AMD GPUs to EC2 instances.
Identity
Create IAM users, manage access keys, and control permissions with policies.
Organise IAM users into groups and manage permissions once for the whole team.
Create IAM roles with trust policies, wrap them in instance profiles, and grant EC2 instances credentials without static keys.
Mint short-lived credentials with STS — assume roles, issue session tokens, and federate Kubernetes workloads with OIDC.
Access instance metadata, user data, and IAM role credentials from inside a guest VM with IMDSv2.
Containers
Run a managed, AWS-compatible Kubernetes cluster on Spinifex — provision the control plane and worker node group, wire up the VPC, IAM, and security groups it needs, and deploy your first workload via the AWS CLI, the Spinifex console, or Terraform.
Run AWS-compatible ECS workloads on Spinifex — create a cluster, register a task definition, boot container instances from the ECS node image, run tasks, and front a long-running service with an Application Load Balancer, all via the AWS CLI, the Spinifex console, or Terraform.
Store and serve container images from Spinifex's AWS-compatible Elastic Container Registry — create a repository, authenticate Docker, push and pull images, and let your EKS workers pull from it, using the AWS CLI, the Spinifex console, or Terraform.
Migration
Security
CVSS-tiered SLAs for identifying, reporting, and correcting software flaws in Spinifex
Operator guide for host-based malware protection and file integrity monitoring on Spinifex nodes
Operator guide for sanitizing and disposing of storage media used by Spinifex nodes
Operator inventory of inbound listeners and outbound connections on Spinifex nodes
Operator guide for physical access controls, visitor handling, access logging, and access-device management at sites hosting Spinifex nodes
Terraform Workbooks
Deploy a bastion host to access an isolated private compute instance with no internet connectivity.
Deploy a Flask file-sharing web application backed by S3 (Predastore) using Terraform on Spinifex.
Deploy a VPC with two private EC2 instances running Nginx, fronted by an internet-facing ALB using Terraform on Spinifex.
Deploy a VPC with a public subnet and an EC2 instance running Nginx using Terraform on Spinifex.
Stand up a minimal managed-Kubernetes cluster and a browsable Spinifex-themed demo app — VPC, IAM roles, an EKS cluster, a one- or three-worker node group, an ECR repository, and a load-balanced web page — using Terraform on Spinifex.
Serve a Spinifex-themed demo app over HTTPS on EKS using the AWS Load Balancer Controller addon and an ACM certificate — an internet-facing ALB provisioned from a Kubernetes Ingress, using Terraform on Spinifex.
Deliver a Spinifex-themed app to EKS with GitOps — the Argo CD addon syncs it from a git repo, an EBS-CSI (Viperblock) PersistentVolume holds its state, and it is served over HTTPS through the AWS Load Balancer Controller + ACM, using Terraform on Spinifex.
Stand up a complete AWS-compatible ECS stack on Spinifex with Terraform — a VPC, IAM roles, a cluster, a task definition with a task role, container instances launched from the ECS node image, and an awsvpc service fronted by an Application Load Balancer.
Stand up a managed PostgreSQL database on Spinifex with Terraform — a VPC, a DB subnet group, a parameter group, an aws_db_instance, and a client VM inside the VPC that connects to it with psql.
Reference Architectures
Provision isolated GPU VMs for simultaneous AI workloads on a Supermicro H14 bare-metal node using Spinifex's EC2-compatible API.
Provision, load, and benchmark arcee-ai/Trinity-Large-Preview-FP8 across two AMD MI350X GPUs on a Supermicro H14 using Spinifex's EC2-compatible API.
Install Spinifex from source, configure host-local networking, attach Predastore storage, and run four concurrent AI workloads across MIG partitions managed inside guest VMs.
Deploy a GPU-accelerated AI inference platform — an OpenAI-compatible LLM API and a real-time CV stream — in Kubernetes on bare-metal hardware, managed entirely with standard AWS tooling.