Skip to content

Linux

Which one do I need?
  • Running Fedora? Use Fedora (Copr), it keeps Pelton updated through dnf.
  • Running Debian, Ubuntu, or a derivative? Use Debian / Ubuntu (.deb).
  • Running Arch or a derivative? Use Arch (AUR).
  • On an RPM-based distro that isn't Fedora? Use Generic RPM.
  • Use Nix if you manage your system (or just your packages) with Nix.
  • Anything else, or you'd rather not install system-wide? Use the Generic binary.

Fedora

Checklist

Installation

Pelton is packaged for Fedora through Copr, Fedora's community repo host. Enabling it adds Pelton's repo to dnf, so future releases show up as normal updates.

sudo dnf copr enable arnek/Pelton
sudo dnf install pelton
  • Enable the Copr repo
  • Install Pelton

Pelton will now start. Go through the Onboarding wizard. To add your first mailbox, see Setting up a mailbox.

Debian / Ubuntu (.deb)

Checklist

Installation

1. Download

Download the .deb from pelton.app/download or from GitHub Releases

  • Download the .deb

Verify Checksum

It's highly recommended to verify the Checksum (SHA-256 hash) of the file you've downloaded.

The download page gives you a ready-to-run verify command next to the install command:

The download page's install and checksum verify commands for the .deb

Open your Terminal and navigate to your downloads folder (cd ~/Downloads), then run the sha256sum ... && echo Match || echo Mismatch command from the page.

If it says Match then you can proceed with the installation and everything is fine.

If it says Mismatch then the file got corrupted or was tampered with. Do not proceed. You can try repeating the download.

  • Verify SHA-256 Checksum

2. Install

sudo dpkg -i Pelton-<VERSION>-linux-amd64.deb
  • Install the .deb

Pelton will now start. Go through the Onboarding wizard. To add your first mailbox, see Setting up a mailbox.

Arch (AUR)

Checklist

Installation

Pelton is available on the AUR as pelton-bin, thanks to leeteral (AUR Maintainer) (GitHub). Install it with your AUR helper of choice:

yay -S pelton-bin

pelton-bin is maintained separately from Pelton's own release pipeline, so it can lag behind a brand new release while the package gets bumped, usually by just a few hours. You can check its current status on Repology, which tracks Pelton's packaging across distros and package managers.

  • Install from the AUR

Pelton will now start. Go through the Onboarding wizard. To add your first mailbox, see Setting up a mailbox.

Generic RPM

Checklist

Installation

If you're not on Fedora but still want a native RPM install (or don't want to add the Copr repo), you can install the .rpm directly.

1. Download

Download the .rpm from pelton.app/download or from GitHub Releases

  • Download the .rpm

Verify Checksum

It's highly recommended to verify the Checksum (SHA-256 hash) of the file you've downloaded.

The download page gives you a ready-to-run verify command next to the install command:

The download page's install and checksum verify commands for the .rpm

Open your Terminal and navigate to your downloads folder (cd ~/Downloads), then run the sha256sum ... && echo Match || echo Mismatch command from the page.

If it says Match then you can proceed with the installation and everything is fine.

If it says Mismatch then the file got corrupted or was tampered with. Do not proceed. You can try repeating the download.

  • Verify SHA-256 Checksum

2. Install

sudo rpm -i Pelton-<VERSION>-linux-fedora-x86_64.rpm
  • Install the .rpm

Pelton will now start. Go through the Onboarding wizard. To add your first mailbox, see Setting up a mailbox.

Generic binary

Checklist

  • Download the binary
  • Verify SHA-256 Checksum
  • Make it executable and run it
  • Go through onboarding
  • Add your first mailbox

Installation

No package manager, no sudo: just a raw binary. Useful on distros without .deb/.rpm support, or if you'd rather run Pelton without installing it system-wide.

1. Download

Download the binary from pelton.app/download or from GitHub Releases

  • Download the binary

Verify Checksum

It's highly recommended to verify the Checksum (SHA-256 hash) of the file you've downloaded.

The download page gives you a ready-to-run verify command next to the run command:

The download page's run and checksum verify commands for the raw binary

Open your Terminal and navigate to your downloads folder (cd ~/Downloads), then run the sha256sum ... && echo Match || echo Mismatch command from the page.

If it says Match then you can proceed with the installation and everything is fine.

If it says Mismatch then the file got corrupted or was tampered with. Do not proceed. You can try repeating the download.

  • Verify SHA-256 Checksum

2. Run it

chmod +x Pelton-<VERSION>-linux-amd64
./Pelton-<VERSION>-linux-amd64
  • Make it executable and run it

Pelton will now start. Go through the Onboarding wizard. To add your first mailbox, see Setting up a mailbox.

Nix

Checklist

Installation

Pelton ships a flake. Point it at a release tag, not the bare repo:

nix run github:TRC-Loop/Pelton/v2026.4

Or install it into your profile:

nix profile install github:TRC-Loop/Pelton/v2026.4
  • Run or install via the flake

Note

Linux only for now.

Pelton will now start. Go through the Onboarding wizard. To add your first mailbox, see Setting up a mailbox.

Need help?

See Support.