Skip to content
Mulgamulga

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.

Learn How

First Time Here?

Try these developer quickstarts.

See All Playbooks Below

Spinifex Support

Access documentation, software, and expert assistance for your Spinifex deployment.

Get Support

All Playbooks

Instructions to set up and configure workloads on Spinifex.

Terraform Workbooks

Bastion with Private Subnet

Deploy a bastion host to access an isolated private compute instance with no internet connectivity.

S3-Backed Web App

Deploy a Flask file-sharing web application backed by S3 (Predastore) using Terraform on Spinifex.

Nginx Web Server (Load Balanced)

Deploy a VPC with two private EC2 instances running Nginx, fronted by an internet-facing ALB using Terraform on Spinifex.

Nginx Web Server

Deploy a VPC with a public subnet and an EC2 instance running Nginx using Terraform on Spinifex.

EKS Quickstart

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.

EKS HTTPS Ingress (LBC + ACM)

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.

GitOps on EKS (Argo CD + EBS-CSI)

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.

ECS Quickstart

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.

RDS Quickstart

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.