Installation
Download, install, and set up Polymerium on Windows, macOS, or Linux.
Last updated on
Download
Grab the latest release for your platform from GitHub Releases.
| Platform | File |
|---|---|
| Windows x64 | Polymerium-win-Setup.exe |
| Linux x64 | Polymerium.AppImage |
| macOS ARM | Polymerium-osx-Setup.pkg |
Each platform uses its standard installer format. Run it and follow the prompts.
Windows: Enable Developer Mode
Polymerium uses symbolic links to share mod files across instances without duplication. On Windows, creating symlinks requires Developer Mode.
- Open Settings → System → For developers
- Toggle Developer Mode on
- Confirm the prompt
This is a one-time setup. It doesn't compromise security — it only allows your user account to create symbolic links, which is the default on macOS and Linux.
macOS and Linux users don't need any special configuration — symlinks work out of the box.
First Launch: The OOBE Wizard
When you open Polymerium for the first time, the OOBE (Out-of-Box Experience) wizard walks you through:
- Welcome & Features — a quick overview of what Polymerium can do.
- Privilege Check — Polymerium tests whether it can create symlinks in its data directory. If this fails on Windows, you need to enable Developer Mode (see above).
- Quick Setup — optionally configure Java paths and language.
- Privacy — choose whether to send crash reports via Sentry.
- Done — you're ready to create your first instance.
What Gets Installed Where
Polymerium stores all its data in ~/.trident/ on every platform. This includes settings, cached files, and your instances.
| Data | Location |
|---|---|
| Settings | ~/.trident/settings.json |
| Persistence DB | ~/.trident/persistence.sqlite.db |
| HTTP cache | ~/.trident/cache.sqlite.db |
| Shared mod cache | ~/.trident/cache/packages/ |
| Game assets | ~/.trident/cache/assets/ |
| Instances | ~/.trident/instances/ |
Want to place data on a different drive? See Custom Data Directory →.
Next Step
Now that Polymerium is running, create your first instance →