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.
Getting Started
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.
Import an AMI, create a VPC with a public subnet, and launch your first EC2 instance on Spinifex.
Administration
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.
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 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.