🍏 Running the Installer on macOS

This page explains how to run the TidaLuna Installer on macOS.

💡 If you're looking for how to use the installer after launching it, see the Quick Start guide.

📥 Download the Correct Archive

1. Go to the Releases page

2. Download the archive that matches your architecture:

   • Apple Silicon (M1/M2/M3/M4): macos-arm64.tar.xz

   • Intel Macs: macos-x64.tar.xz

🛠 Not sure which one you need? If you’re on a newer Mac (M1 or later), start with the arm64 version. If that doesn’t work, try x64.

📦 Extract & Prepare

1. Extract the .tar.xz file. You can do this in the Terminal:

   tar -xf macos-arm64.tar.xz    # or macos-x64.tar.xz
   

2. Inside the extracted folder, you’ll find: luna-installer

3. Open Terminal in that folder and run the following commands before executing:

   xattr -d com.apple.quarantine luna-installer
   codesign -s - -f --deep luna-installer
   chmod +x luna-installer
   

❗ If you skip this step, macOS may prevent execution and display:

zsh: killed luna-installer

Allow the installer to edit Tidals files

1. Open the Settings app of your Mac

2. Navigate to Privacy and Security -> App Management

3. Check "Terminal" to allow it to update / delete other applications

   

🚀 Run the Installer

Now launch it:

./luna-installer

A browser window should automatically open to http://localhost:3013. If it doesn't, open that URL manually in your browser.

✅ Verified Setup

• Device: Mac mini M4
• OS: macOS Sequoia 15.5
• Fix applied: xattr, codesign, and chmod steps as shown above

Need help using the installer itself? Head over to the Quick Start guide.