Mirrion

Local development for macOS

Run your web projects locally.

Give each site its own environment and HTTPS address. Open it on your Mac or test it in the browser on your phone.

Download for macOS See how it works

Apple silicon macOS 26 or later

Full Mirrion window showing its sidebar, running and stopped projects, and project controls
The Projects window shows each site’s status and controls. Some project names are hidden.

Workflow

From project folder to local HTTPS

  1. Choose a folder

    Create a project and give it a local domain, such as studio.test.

  2. Pick an environment

    Select a ready-made environment or build one from compatible components.

  3. Open your site

    Start the project in Mirrion and open it at its local HTTPS address.

Running sites stay available after you quit Mirrion

Mirrion Runtime serves started projects in the background while your Mac and the runtime are running. You can keep using their HTTPS addresses on the Mac and on your local network if LAN Access is enabled. To take a site offline, reopen Mirrion and click Stop next to the project.

Local HTTPS & device testing

Test the way your site will be used

Open your project over HTTPS

Give the project a local domain, such as mirrion.test, then use Open Site from the Projects list. Mirrion serves the project over HTTPS with a local certificate. Trust the certificate on your Mac so the browser can verify the connection.

Use the HTTPS address to check behavior that depends on a secure connection, such as secure cookies and browser APIs.

Mirrion project settings with the mirrion.test domain and phone access enabled
Set the local domain and allow phone access in Project Settings.

Open the same project on your phone

  1. Enable phone access in Project Settings. Connect your phone to the same local network as your Mac.
  2. With the project running, open LAN Access using the QR button in Mirrion.
  3. Install and trust the local certificate on the test device, then scan the QR code to open the project’s HTTPS address.

On iPhone, Mirrion can send the certificate via AirDrop. After installing it, enable trust in Settings → General → About → Certificate Trust Settings. Apple’s certificate instructions.

Mirrion’s LAN Access dialog with an example QR code and buttons for AirDrop and Finder
LAN Access shows the address and certificate-sharing options. The QR code shown here is an example.

Try camera-based WebAR before deploying

Run your WebAR project in Mirrion, open it over trusted HTTPS on the test phone, and check the camera permission flow and marker tracking on the device. The same setup lets you test web experiences that request camera or microphone access.

The browser still asks for permission. Immersive WebXR also requires a compatible browser and device. WebXR specification.

Running WebAR project in Mirrion with Open Site and the LAN Access QR button
A WebAR project running locally in Mirrion with Open Site and LAN Access available.

Environments

A stack for each project

Use an existing environment or create one with the versions your project needs. Mirrion Runtime runs each project in an isolated environment on your Mac.

Web servers
Apache, Nginx, OpenLiteSpeed
Application runtime
PHP, optional Node.js 24
Optional databases
MySQL, MariaDB, PostgreSQL
New Environment dialog showing Apache, PHP, MySQL and an optional Node.js switch
Choose compatible components in the New Environment dialog.
Full Mirrion Environments window showing the sidebar, available stacks, included services, storage usage and HTTPS support
The Environments window shows what each stack includes and how much disk space it uses. Local file paths are hidden.

Download

Mirrion for macOS

Running local projects with Mirrion Runtime requires an Apple silicon Mac with macOS 26 or later.

Download Mirrion 1.0

Apple silicon · ZIP · 25.8 MB

Includes the app, signing script, and a copy of this website.

Installation instructions

Installation

Install Mirrion on your Mac

Use an Apple silicon Mac with macOS 26 or later to run local projects.

  1. Extract the ZIP

    Open the downloaded archive and move Mirrion.app to Applications.

  2. Reapply the local signature if needed

    Quit Mirrion if it’s open. In Terminal, type cd followed by a space, drag the extracted Mirrion-1.0 folder into the Terminal window, and press Return. Run this command and look for Local signature verified.

    ./sign-mirrion.sh /Applications/Mirrion.app

  3. Set up Mirrion Runtime

    Open Mirrion from Applications. In Settings, choose Install Mirrion Runtime if prompted. Once it’s available, create or open a project and click Start.

This local test build uses an ad hoc signature. It has no Apple notarization, so Gatekeeper may block it depending on your Mac’s security settings.