Home

👋 Welcome to Tartelet - a macOS app that launches self-hosted GitHub Actions runners in virtual machines using Tart.

Tartelet makes it a breeze to manage up to two GitHub Actions runners in ephemeral virtual machines on a single host machine. The benefits are that runners can run in parallel and each job runs in an isolated environment that is recreated after each GitHub Actions job has finished.

🚀 Getting Started

• Installing Tartelet
• Configuring Tartelet
• Starting the Virtual Machines
• Executing Scripts

⚡️ Advanced

• Configuring the Virtual Machine to Build iOS Apps
• Updating Software Installed on a Virtual Machine
• Copying a Virtual Machine
• Setting Up a Host Machine

🗯️ Terminology

The following table contains some terminology used throughout the articles.

Phase	Meaning
Host machine	A physical machine on which the Tartelet app is installed. This machine is responsible for managing the virtual machines.
Virtual machine	A machine managed by the host machine. This machine is responsible for running the GitHub Actions runner. The virtual machines are ephemeral, meaning they are deleted when they have run a job and are then recreated.
Editing a virtual machine	Booting virtual machine selected in Tartelet's settings and making changes to it, such as installing new software on the machine. This is done by selecting "Virtual Machine" and then "Edit Virtual Machine" in Tartelet's menu bar.
Starting the fleet of virtual machines	When the fleet of virtual machines is started, Tartelet will keep either one or two virtual machines running at a time. When one virtual machine is shutdown, Tartelet will delete it and recreate it."
Stopping the fleet of virtual machines	Tartelet will shutdown and delete its virtual machines and not create new ones until the fleet is started again.