// reference

Documentation

Browse documentation for InfraHouse Terraform modules, Python automation tools, and testing frameworks. Production-ready infrastructure built with compliance in mind.

Production-ready infrastructure tools built with ISO 27001 compliance, monitoring, and operational excellence in mind.

Terraform Modules

Infrastructure as Code modules for AWS. All modules are available on the HashiCorp Terraform Registry and our private registry.

Featured

These modules have comprehensive documentation with getting started guides, architecture diagrams, and configuration references.

GitHub Actions Runner

Self-hosted GitHub Actions runners on AWS with warm pool support, Puppet integration, and ISO 27001 compliant monitoring.

Docs GitHub Registry

ECS

Production-ready ECS service deployment with ALB, autoscaling, and integrated monitoring.

GitHub Registry

SQS ECS

ECS service that scales based on SQS queue depth for background job processing.

GitHub Registry

OpenVPN

OpenVPN server with Google OAuth authentication for secure remote access to AWS resources.

GitHub Registry

Secret

AWS Secrets Manager secret with owner/writer/reader IAM roles for fine-grained access control.

GitHub Registry

Website Pod

Autoscaling group with ALB and SSL certificate for web applications.

GitHub Registry

All Modules

GitHub Actions Runner

Self-hosted GitHub Actions runners on AWS with warm pool support, Puppet integration, and ISO 27001 compliant monitoring.

Docs GitHub Registry

ECS

Production-ready ECS service deployment with ALB, autoscaling, and integrated monitoring.

GitHub Registry

SQS ECS

ECS service that scales based on SQS queue depth for background job processing.

GitHub Registry

OpenVPN

OpenVPN server with Google OAuth authentication for secure remote access to AWS resources.

GitHub Registry

Secret

AWS Secrets Manager secret with owner/writer/reader IAM roles for fine-grained access control.

GitHub Registry

Website Pod

Autoscaling group with ALB and SSL certificate for web applications.

GitHub Registry

Cloud Init

Cloud-init userdata generation with Puppet support for EC2 instance bootstrapping.

GitHub Registry

Instance Profile

IAM instance profile with configurable policies for EC2 instances.

GitHub Registry

Jumphost

Secure bastion host for SSH access to private resources.

GitHub Registry

TCP Pod

Autoscaling group with NLB for TCP-based services.

GitHub Registry

Service Network

VPC with public and private subnets, NAT gateway, and internet gateway.

GitHub Registry

State Bucket

S3 bucket with DynamoDB table for Terraform state storage and locking.

GitHub Registry

State Manager

IAM role for secure Terraform state management with S3 and DynamoDB.

GitHub Registry

GHA Admin

IAM roles for managing AWS infrastructure with GitHub Actions CI/CD.

GitHub Registry

Lambda Monitored

AWS Lambda with built-in error alerting, throttle monitoring, and CloudWatch integration.

GitHub Registry

Elasticsearch

Self-managed Elasticsearch cluster on EC2 with master and data nodes.

GitHub Registry

Kibana

Kibana deployment on ECS for Elasticsearch visualization.

GitHub Registry

Debian Repository

Debian APT repository backed by S3 and fronted by CloudFront.

GitHub Registry

BookStack

BookStack wiki deployment on ECS with RDS backend.

GitHub Registry

Postfix

Postfix MX server deployment for email receiving.

GitHub Registry

PyPI Server

Private PyPI server for Python package hosting.

GitHub Registry

Trust Store

ALB trust store with generated CA certificate for mTLS.

GitHub Registry

Terraformer

Dedicated EC2 instance for administrative Terraform operations.

GitHub Registry

Update DNS

Lambda that manages DNS A records for instances in an autoscaling group.

GitHub Registry

View all 48+ modules →

Python Automation

CLI tools and libraries for AWS infrastructure management. Install via pip install <package-name>.

InfraHouse Toolkit

CLI tools for AWS infrastructure management. Includes ih-plan, ih-ec2, ih-secrets, ih-certbot, and more.

Docs GitHub PyPI

InfraHouse Core

Python library with AWS helper classes for EC2, S3, Route53, and other services.

Docs GitHub PyPI

Installation

# Install the toolkit (includes CLI commands)
pip install infrahouse-toolkit

# Install the core library
pip install infrahouse-core

CLI Tools Included

The infrahouse-toolkit provides these commands:

Command	Description
`ih-aws`	General AWS utilities
`ih-certbot`	SSL certificate management
`ih-ec2`	EC2 instance management
`ih-elastic`	Elasticsearch management
`ih-github`	GitHub API utilities
`ih-openvpn`	OpenVPN server management
`ih-plan`	Terraform plan with enhanced output
`ih-puppet`	Puppet integration helpers
`ih-registry`	Private Terraform registry operations
`ih-s3`	S3 bucket management
`ih-s3-reprepro`	APT repository management in S3
`ih-secrets`	Secrets Manager operations
`ih-skeema`	MySQL/MariaDB schema management

Python Testing

Pytest plugins and fixtures for testing infrastructure code against real AWS.

pytest-infrahouse

Pytest fixtures for testing Terraform modules against real AWS infrastructure.

GitHub PyPI

Usage

# conftest.py
pytest_plugins = ["pytest_infrahouse"]

# test_my_module.py
def test_my_terraform_module(ec2_client, terraform_apply):
    """Test that the module creates expected resources."""
    terraform_apply("path/to/module")
    
    instances = ec2_client.describe_instances()
    assert len(instances["Reservations"]) > 0

Design Principles

All InfraHouse tools follow these principles:

Compliance Ready

Built for ISO 27001 and SOC 2. Monitoring, log retention, and encryption configured by default.

Observable

Integrated CloudWatch metrics, alarms, and SNS alerting. Know when something breaks before your customers do.

Composable

Tools work together seamlessly. Terraform modules use our Python libraries. Tests use our pytest fixtures.

Tested

Everything is tested against real AWS infrastructure. We don't ship code we haven't deployed.

Need help with your AWS infrastructure?

Schedule a Free Assessment