Where to Find Tart Virtualization Documentation and Support Resources
Updated
Tart Virtualization's documentation is organized into six main sections on tart.run: Quick Start, Integrations, Orchestration, Support & Licensing, Legal, and Blog. Which one you need depends on whether you're setting up the core toolset, connecting it to CI systems, running VMs at scale with Orchard, or checking terms and updates. The site describes Tart as "a virtualization toolset to build, run and manage macOS and Linux virtual machines on Apple Silicon," so the docs assume Apple Silicon hardware throughout.
Start here: Quick Start for the core toolset
If you're new to Tart, the Quick Start section is the entry point for building, running, and managing macOS and Linux VMs locally. The site highlights three things this core toolset delivers:
- Native performance on Apple Silicon
- Remote storage for Virtual Machines
- Seamless integration with your existing automations
Use this section when your goal is to get a first VM running or to understand the basic build/run/manage workflow before adding automation or orchestration.
Integrations: CI and automation tools
The Integrations section covers connecting Tart to existing pipelines. The site lists these integrations:
| Integration | What it's for |
|---|---|
| Self-hosted CI | Running Tart VMs inside your own CI infrastructure |
| GitHub Actions | GitHub-based automation |
| GitLab Runner | GitLab pipelines |
| Buildkite | Buildkite pipelines |
| Packer | Image building workflows |
Go here if your question is about wiring Tart into a specific CI system rather than running VMs by hand.
Orchestration: running at scale with Orchard
The Orchestration section is dedicated to Orchard, the component for running Tart "at scale." Its subpages are:
- Quick Start — getting Orchard running
- Architecture and Security — how the system is structured and secured
- Deploying Controller and Deploying Workers — the two deployment roles
- Using Orchard CLI — command-line management
- Managing the Cluster — ongoing cluster operations
- Integrating with the API — programmatic access
Choose this section when a single machine is no longer enough and you need a controller/worker cluster. If you only need to know what Orchard is at a conceptual level, the Architecture and Security page is the most direct read.
Support, licensing, and legal
The Support & Licensing section is where to look for commercial support and licensing terms. The Legal section holds the Terms of Service and Privacy pages. Check these before deploying in a commercial or regulated context, since licensing conditions may affect how you roll Tart out.
Blog and archive for updates
The Blog section, with a Blog Archive spanning 2023, 2024, and 2025, is where announcements are published. Posts are categorized (for example, "announcement" and "orchard"), so you can filter for release news or Orchard-specific changes. Check here when you want to know what's changed recently rather than how something works.
Choosing the right section
- First-time setup on a single Mac → Quick Start
- Connecting to GitHub Actions, GitLab, Buildkite, Packer, or self-hosted CI → Integrations
- Running many VMs across machines → Orchestration (start with Architecture and Security, then Deploying Controller/Workers)
- Licensing or commercial support questions → Support & Licensing
- Terms, privacy, or recent announcements → Legal or Blog
The site's top navigation also links directly to GitHub and Home, so source code and the landing page are one click away if the docs don't cover your case.