Features Docs Resources Changelog Download

Getting Started

Welcome to Tun! This guide will help you get up and running with your first local Craft CMS development environment.

Architecture

Tun consists of two main components:

  • Tun Engine — A Go-based CLI and daemon that manages Craft sites and orchestrates the containerised runtime
  • Tun App — A Tauri desktop application (Rust backend + React/TypeScript frontend) that provides the user interface

The Tun Engine daemon runs on http://127.0.0.1:4343 and provides an HTTP API that the desktop application consumes.

Installation

Download Tun for your platform from the homepage. The application includes both the desktop app and the engine daemon.

On first launch, Tun will:

  • Start the Tun Engine daemon automatically
  • Detect available container backends (OrbStack, Colima, Podman, or Docker Engine)
  • Guide you through creating your first site

System Requirements

Tun requires:

  • macOS: 10.15 (Catalina) or later
  • Windows: Windows 10 or later (with WSL2 for container support)
  • Linux: Modern distribution with GTK3 or WebKit2GTK
  • A Docker-compatible container runtime (OrbStack recommended for macOS, Colima, Podman, or Docker Engine)
  • Composer (installed locally, required for initialising Craft CMS projects)

Container Backend Setup

Tun works with multiple container backends. Choose one that suits your platform:

  • OrbStack — Native macOS container runtime (recommended for macOS)
  • Colima — Container runtime for macOS/Linux
  • Podman — Daemonless container engine
  • Docker Engine — Standard Docker runtime

Tun will automatically detect which backend is available and use it for container orchestration.

First Steps

After installation, you'll see the Tun interface with an empty site list. You can create your first site using one of three methods:

  1. Create from scratch — Use the guided wizard to set up a new Craft CMS site
  2. Import from ZIP — Import an existing site from a ZIP backup
  3. Create from blueprint — Use a saved blueprint for consistent project setups

Once created, Tun will handle container orchestration, database setup, Nginx configuration, and Craft CMS installation automatically.