> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fau.fpt.icu/llms.txt
> Use this file to discover all available pages before exploring further.

# Installation Guide

> Install fp-appimage-updater via COPR, Homebrew, the quick-install script, or a pre-built binary.

Choose the method that matches your distribution and preferences.

<Tabs>
  <Tab title="Fedora / OpenSUSE (COPR)">
    The official COPR repository is the recommended method for RPM-based distributions. It integrates with your package manager and keeps the tool updated automatically.

    ```bash theme={null}
    sudo dnf copr enable fptbb/fp-appimage-updater
    sudo dnf install fp-appimage-updater
    ```

    After installation, `fp-appimage-updater` is available on your PATH and managed by `dnf`.
  </Tab>

  <Tab title="Quick install script">
    The install script works on any Linux distribution, including immutable and atomic systems. By default it installs to `~/.local/bin/` and sets up a systemd user timer for background updates.

    In plain terms, the script does three things:

    * puts the binary on your `PATH`
    * creates the user timer if you allow background updates
    * leaves your recipes, state, and AppImages in your home directory

    ```bash theme={null}
    curl -sL fau.fpt.icu/i | bash
    ```

    **Options:**

    Skip the systemd background timer if you prefer to run updates manually:

    ```bash theme={null}
    curl -sL fau.fpt.icu/i | bash -s -- --no-systemd
    ```

    Install system-wide to `/usr/bin/` and `/usr/lib/systemd/system/` (requires root, rejected on strictly immutable systems):

    ```bash theme={null}
    curl -sL fau.fpt.icu/i | sudo bash -s -- --system
    ```

    Uninstall the binary and disable all running systemd timers across any scope:

    ```bash theme={null}
    curl -sL fau.fpt.icu/i | bash -s -- --uninstall
    ```

    <Note>
      The uninstall option leaves your AppImage binaries and configuration files in `~/.config/fp-appimage-updater/` intact.
    </Note>
  </Tab>

  <Tab title="Pre-built binaries">
    Download the latest compiled binary for your architecture directly from the releases page:

    **[https://gitlab.com/fpsys/fp-appimage-updater/-/releases](https://gitlab.com/fpsys/fp-appimage-updater/-/releases)**

    Drop it into your preferred binary directory and make it executable:

    ```bash theme={null}
    chmod +x fp-appimage-updater
    mv fp-appimage-updater ~/.local/bin/
    ```

    The binary is a fully self-contained executable with no runtime dependencies. Self-update works out of the box — you can run `fp-appimage-updater self-update` to upgrade to the latest release at any time.
  </Tab>

  <Tab title="Homebrew (tap)">
    If you prefer Homebrew, you can install the Linux binary from the GitLab-hosted tap:

    ```bash theme={null}
    brew tap fpsys/tap https://gitlab.com/fpsys/homebrew-tap.git
    brew install fp-appimage-updater
    ```

    Installing this way does not install the systemd service automatically.
  </Tab>
</Tabs>

<Note>
  For a standard user-wide install, `sudo` is never required. The binary and all configuration live entirely in your home directory under `~/.local/` and `~/.config/`.
</Note>