# Installation

Download the latest release from [GitHub Releases](https://github.com/nukeop/nuclear/releases). Pick the file that matches your platform.

{% tabs %}
{% tab title="Windows" %}

| File                          | What it is                                                                               |
| ----------------------------- | ---------------------------------------------------------------------------------------- |
| `Nuclear_x.y.z_x64-setup.exe` | Interactive installer. Installs per-user, no admin required. Recommended for most users. |
| `Nuclear_x.y.z_x64_en-US.msi` | MSI installer. For system-wide or managed deployments (e.g. via Group Policy).           |

Run the installer and follow the prompts. Nuclear will be available from the Start menu after installation.
{% endtab %}

{% tab title="macOS" %}

| File                        | What it is                                          |
| --------------------------- | --------------------------------------------------- |
| `Nuclear_x.y.z_aarch64.dmg` | Disk image for Apple Silicon Macs (M1, M2, M3, M4). |
| `Nuclear_x.y.z_x64.dmg`     | Disk image for Intel Macs.                          |

Open the `.dmg` and drag Nuclear to your Applications folder.

#### Gatekeeper warning

Nuclear is not signed with an Apple Developer certificate. macOS will block it from opening the first time. To allow it:

1. Right-click the app in your Applications folder and select **Open**
2. Click **Open** in the dialog that appears

If that doesn't work, run this in Terminal:

```bash
sudo xattr -r -d com.apple.quarantine /Applications/Nuclear.app
```

You only need to do this once.
{% endtab %}

{% tab title="Linux" %}

| File                           | What it is                                                                                                |
| ------------------------------ | --------------------------------------------------------------------------------------------------------- |
| `Nuclear_x.y.z_amd64.AppImage` | Portable binary. No installation needed, just make it executable and run it. Works on most distributions. |
| `Nuclear_x.y.z_amd64.deb`      | Debian package for Ubuntu, Debian, Pop!\_OS, and other Debian-based distributions.                        |
| `Nuclear-x.y.z-1.x86_64.rpm`   | RPM package for Fedora, openSUSE, and other RPM-based distributions.                                      |

#### Flatpak

Nuclear is available on [Flathub](https://flathub.org/en/apps/com.nuclearplayer.Nuclear). This is the recommended way to install on Linux if your distribution supports Flatpak, since Flathub handles updates automatically.

```bash
flatpak install flathub com.nuclearplayer.Nuclear
```

Note that the Flatpak sandbox may prevent some features from working. If you run into issues, try the `.deb`, `.rpm`, or AppImage instead.

#### Arch Linux

Nuclear is available in the AUR:

* [nuclear-player-bin](https://aur.archlinux.org/packages/nuclear-player-bin) - prebuilt binary
* [nuclear-player-git](https://aur.archlinux.org/packages/nuclear-player-git) - built from source

Install with your AUR helper of choice, e.g.:

```bash
yay -S nuclear-player-bin
```

{% endtab %}
{% endtabs %}

## Auto-updates

Nuclear checks for updates on startup and can install them automatically. You can toggle this in Settings under **General > Updates**.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.nuclearplayer.com/nuclear/user-manual/installation.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.