Trinity Launcher Installation

Complete guide for Linux systems

Trinity Launcher is a community-driven project distributed primarily as a Flatpak package to ensure maximum compatibility and security across the Linux ecosystem.

Before you start

Make sure you have Flatpak installed on your system. This ensures that the launcher and its dependencies (like the community-maintained Minecraft Bedrock engines) run in a stable, isolated environment.

If you don't have it yet, visit the official setup guide: Go to Flatpak.org

Install Trinity Launcher

Choose the method that best fits your workflow.

Method A: From Testing-Beta Repository (RECOMMENDED)

This is the preferred way for community members who want the latest features and automatic updates directly from our development pipeline.

Run these commands in order in your terminal:

1. Remove the Trinity repository (if you had the old version):

   flatpak remote-delete trinity

2. Add the Trinity repository:

   flatpak remote-add trinity https://github.com/Trinity-LA/Trinity-Launcher/releases/download/flatpak/com.trench.trinity.launcher.flatpakrepo

3. Install the dependencies (KDE runtime and Qt WebEngine):

   flatpak install flathub org.kde.Platform//6.10 io.qt.qtwebengine.BaseApp//6.10

4. Install Trinity Launcher:

   flatpak install com.trench.trinity.launcher

Advantages: Direct access to latest beta versions and automatic background updates.

Method B: From Software Store

If you prefer a graphical interface:

1. Remove the old repository (if applicable):

   flatpak remote-delete trinity

2. Add the repository first:

   flatpak remote-add trinity https://github.com/Trinity-LA/Trinity-Launcher/releases/download/flatpak/com.trench.trinity.launcher.flatpakrepo

3. Search for "Trinity Launcher" in your Software Store (GNOME Software, Discover).

   Note: You may need to restart the store after adding the repo.

Method C: AppImage (Beta - Portable)

Ideal for users who prefer manual management without package managers.

1. Download:

2. Install Gear Level: Search for "Gear Level" in your App Store and install it.

3. Open with Gear Level: Right-click the .AppImage file -> Open With -> Gear Level.

4. Unlock & Integrate: Click "Unlock" to make it executable and "Add to apps menu" for easy access.

Remote Login (AppImage Only)

Local vs Remote

This step is only required for the AppImage version to enable Microsoft account authentication.

Step 1: Enable in Settings

1. Open Trinity and go to Settings.
2. Navigate to Account Settings and toggle Remote Login.
3. Restart the game completely.

Step 2: Browser Authentication

1. Go to microsoft.com/link.
2. Enter the code shown in the game.
3. Complete the login in your browser.
4. Close the dialog in the game.

---

Run Trinity Launcher (Flatpak)

• From Menu: Search for "Trinity Launcher" in your applications dashboard.
• From Terminal:

  flatpak run com.trench.trinity.launcher

---

Method D: NixOS

For NixOS and other Nix-based users, read the official steps:

• Steps for running on NixOS or using Nix

Method E: macOS (Beta - DMG)

Download and extract trinity-macos-dmg:

• Click to download DMG x86_64
• Click to download DMG ARM

Move Trinity.app to your Applications folder, then run it from the terminal:

cd /Applications/Trinity.app/Contents/MacOS/
./trinity-bin

Troubleshooting

If you get the message "Trinity not opened; Apple could not verify Trinity is free of malware", go to System Settings > Privacy & Security, scroll down and you should see "Trinity was locked" with an Open Anyway option. Click Open Anyway.

• Make sure the app is in the Applications folder.

Need help?

Join our Discord community to get support

Stay updated

Follow our community on Fluxer

Join the Community

Discuss in our Reddit community at r/TrinityUnix