Home - mensfeld/code-on-incus GitHub Wiki

Welcome to the code-on-incus wiki!

New to COI? Start with the README for installation and Quick Start, then read Configuration and Container Lifecycle and Sessions to understand how things work.

Documentation

Setup and Installation

• Linux Setup Guide - Distro-specific setup (Arch, Fedora, openSUSE, Ubuntu)
• macOS Setup Guide - Running COI on macOS with Colima/Lima

Configuration and Usage

• Configuration - Config files, hierarchy, per-repo .coi/config.toml, full reference, and environment variables
• Profiles - Self-contained profile directories with build scripts, context files, and full config bundling
• Supported Tools - Claude Code, opencode, and adding new AI tools
• Container Lifecycle and Sessions - Understanding how containers and sessions work
• Container Operations - Container management and low-level operations
• Snapshot Management - Create checkpoints, rollback, and branch experiments
• File Transfer - Push/pull files between host and containers
• Tmux Automation - Automate AI sessions with tmux commands
• Image Management - Create and manage custom images
• Resource and Time Limits - Control container resource consumption and runtime

Security

• Security Monitoring - Real-time threat detection, automated response, and audit logging
• Security Best Practices - Git hooks protection, path security, and safe commit practices
• Network Isolation - Network security modes and firewalld setup

Maintenance

• Self-Update - Update COI to the latest release (coi update)

Help and Reference

• System Health Check - Diagnose setup issues and verify configuration
• FAQ - Frequently Asked Questions about COI
• Troubleshooting - Common issues and solutions