arillso

The simple, flexible, robust and powerful automation platform

Production-ready Ansible collections, container images, and development tools for modern infrastructure automation.

Build, Deploy, and Manage Infrastructure with Confidence

Get Started Explore Collections

---

🚀 Quick Start in Minutes

Get started with arillso in under 5 minutes. Install collections, run your first playbook.

Quick Start Guide →

📚 Complete Examples

Production-ready playbooks for web stacks, Kubernetes, monitoring, and more.

View Examples →

🔒 Security First

Built-in security best practices, hardening guides, and compliance patterns.

Security Guide →

Why Choose arillso?

Production-Ready & Battle-Tested

All components are tested in production environments with comprehensive CI/CD, security scanning, and 80%+ code coverage.

Consistent Standards Everywhere

Unified development standards, CI/CD workflows, and documentation across all projects. No surprises.

100% Open Source & MIT Licensed

Use freely in any project - personal, commercial, or enterprise. No restrictions.

Active Development & Support

Regular updates, security patches, and new features driven by real-world production needs.

Comprehensive Documentation

From quick starts to architecture guides - everything you need to succeed.

---

Quick Start

Choose Your Path

System Administrator

Manage servers, packages, firewall, networking, system configuration

ansible-galaxy collection install arillso.system

Learn More →

Container Orchestration

Deploy Docker, K3s, Kubernetes clusters, container workloads

ansible-galaxy collection install arillso.container

Learn More →

Agent Management

Grafana Alloy, Tailscale, metrics, logs, traces, vpn

ansible-galaxy collection install arillso.agent

Learn More →

Installation Options

Ansible Collections

# Install all collections
ansible-galaxy collection install arillso.system
ansible-galaxy collection install arillso.container
ansible-galaxy collection install arillso.agent

# Or use requirements file
cat > requirements.yml <<EOF
---
collections:
  - name: arillso.system
    version: ">=1.0.0"
  - name: arillso.container
    version: ">=1.0.0"
  - name: arillso.agent
    version: ">=1.0.0"
EOF
ansible-galaxy collection install -r requirements.yml

Container Image

# Pull optimized Ansible image (with Mitogen)
docker pull arillso/ansible:latest

# Run playbook in container
docker run --rm \
  -v $(pwd):/workspace \
  -v ~/.ssh:/root/.ssh:ro \
  arillso/ansible ansible-playbook site.yml

Go Library

# Programmatic Ansible execution
go get github.com/arillso/go.ansible

GitHub Actions

# .github/workflows/deploy.yml
- name: Deploy Infrastructure
  uses: arillso/action.playbook@v1.2.0
  with:
    playbook: deploy.yml
    inventory: production.yml
    private_key: ${{ secrets.SSH_PRIVATE_KEY }}

---

Popular Use Cases

Real-world scenarios with complete, working examples:

Use Case	What You Get	Guide
Docker Server	Docker with firewall and Tailscale VPN	Docker Application Server
K3s Cluster	Lightweight Kubernetes cluster setup	K3s Cluster Setup
Developer Workstation	Python, Docker, and dev tools	Developer Workstation
System Hardening	Firewall, SSH rate limiting, kernel tuning	System Hardening

View All Use Cases →

---

Platform Components

Ansible Collections

Production-ready roles, modules, and plugins.

Collection	Features	Documentation
arillso.system	Packages, firewall, network, logging, tuning, access control	arillso.system
arillso.container	Docker, K3s, Helm, Fleet GitOps, Tailscale mesh	arillso.container
arillso.agent	Grafana Alloy, DigitalOcean agent, Tailscale VPN	arillso.agent

Total: 24+ roles, 10+ plugins, 5+ modules

Container Images

Image	Features
arillso/ansible	Alpine-based • Mitogen (2-7x faster) • K8s tools • Multi-platform (amd64, arm64)

Pull: docker pull arillso/ansible:latest

Go Libraries

Library	Features
go.ansible	Programmatic playbook execution • Galaxy integration • Context-aware

Install: go get github.com/arillso/go.ansible

GitHub Actions

Action	Features
action.playbook	Run playbooks in CI/CD • SSH key normalization • Vault support

Use: arillso/action.playbook@v1.2.0

---

Architecture & Design

        mindmap
  root((arillso Platform))
    Ansible Collections
      arillso.system
      arillso.container
      arillso.agent
    Container Images
      arillso/ansible
      Mitogen optimized
      Multi-platform
    Go Libraries
      go.ansible
      Programmatic API
      Context-aware
    GitHub Actions
      action.playbook
      CI/CD ready
      Vault support
    

Key Design Principles:

• Modularity - Independent but composable components

• Production-Ready - Battle-tested with comprehensive testing

• Security First - SHA-pinned deps, CodeQL, Trivy scanning

• Consistency - Unified standards across all projects

Read Architecture Guide →

---

Features & Quality

🔒

Security

• SHA-pinned GitHub Actions
• CodeQL & Trivy Scanning
• Non-root Containers
• Vault & Bitwarden Integration
• CIS, PCI-DSS, GDPR Ready

Security Guide →

🧪

Testing

• pytest with 80%+ coverage
• ansible-test end-to-end
• Molecule multi-platform
• Ubuntu, Debian, RHEL, Alpine
• amd64, arm64 tested

⚙️

CI/CD

• CHANGELOG-driven releases
• Renovate dependency automation
• Consolidated workflows
• GitHub Rulesets protection
• Quality gates enforced

CI/CD Standards →

✨

Code Quality

• ansible-lint production profile
• yamllint validation
• golangci-lint for Go
• Pre-commit hooks
• EditorConfig consistency

---

Documentation Hub

🚀 Getting Started

Quick Start Guide Get up and running in 5 minutes Development Environment Set up your development environment Platform Architecture Understand the platform design

📚 Working with arillso

Use Cases 10+ real-world scenarios Complete Examples Complete playbook examples Security Best Practices Security best practices

📖 Reference

Compatibility Matrix Version compatibility matrix Troubleshooting FAQ and debugging guide Repository Standards Repository standards Contributing Guide Contribution guidelines

---

Community & Support

🐙 GitHub

Browse source code, report issues, contribute

github.com/arillso

🌟 Ansible Galaxy

Download collections, view stats

galaxy.ansible.com/arillso

🐳 Docker Hub

Pull container images

hub.docker.com/r/arillso

Need Help?

Choose the best option for your needs:

💬 GitHub Discussions Ask questions, share ideas, get community support 🐛 Report Issue Found a bug? Report it in the project repository ✉️ Email Support hello@arillso.io

Get Help:

• Documentation Issues? Open an issue on guide repository

• Bug Reports? Use the issue tracker in the respective project repository

• Questions? Check Troubleshooting & FAQ first

• Contributing? Read Contributing

---

Statistics

24+

Production Roles

10+

Plugins & Filters

80%+

Code Coverage

100%

Open Source

---

License

All arillso projects are released under the MIT License.

Copyright (c) 2022-2026, arillso

---

Ready to Get Started?

Choose your path and start automating your infrastructure today.

Quick Start Guide View Examples Browse Collections

Contributing • FAQ • GitHub • Ansible Galaxy