Linux Guide - jxnxsdev/TidaLuna-Installer GitHub Wiki

🐧 Running the Installer on Linux

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

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


📥 Download the Installer

  1. Go to the Releases page

  2. Download the archive: linux-x86_64.tar.xz

📦 Extract & Prepare

  1. Open a terminal and navigate to the folder where the archive was downloaded.

  2. Extract the contents:

    tar -xf linux-x86_64.tar.xz
    
  3. Inside the extracted folder, you’ll find the binary: luna-installer

  4. Make the binary executable:

    chmod +x luna-installer
    

🚀 Run the Installer

Start the installer by running:

./luna-installer

This will launch a local web interface. A browser window should open to:

http://localhost:3013

If it doesn't open automatically, copy and paste the URL into your browser manually.

🛠 Troubleshooting

If the binary doesn't run:

  • Make sure it's marked as executable with chmod +x luna-installer
  • Try running it as root using sudo ./luna-installer
  • Ensure you have the necessary permissions (try running with ./luna-installer instead of double-clicking)
  • Check if your system blocks unsigned binaries (some distributions may require additional permissions)

✅ Compatible systems

The installer should work on most modern 64-bit Linux distributions including:

  • Ubuntu
  • Debian
  • Fedora
  • Arch Linux
  • Pop!_OS
  • Steam Deck (Desktop Mode)

Once it's running, follow the Quick Start guide to install, reinstall, or uninstall TidaLuna.