Skip to main content

Manual Installation

If you prefer not to use the one-line installer, you can set up yeet manually using the instructions below for your package manager.

note

yeet only supports Linux natively. macOS and Windows users should use Docker instead.

APT (Debian, Ubuntu, and derivatives)

This covers Debian, Ubuntu 20.04+, and Ubuntu-based distros like Kali Linux, Linux Mint, Pop!_OS, Zorin, and KDE Neon.

First, add the yeet signing key and repository:

Debian:

sudo mkdir -p -m 0755 /usr/share/keyrings

curl -fsSL "https://pkgs.yeet.cx/debian/yeet.noarmor.gpg" \
| sudo tee /usr/share/keyrings/yeet-archive-keyring.gpg >/dev/null

echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/yeet-archive-keyring.gpg] \
https://pkgs.yeet.cx/debian $(. /etc/os-release; echo $VERSION_CODENAME) stable" \
| sudo tee /etc/apt/sources.list.d/yeet.list >/dev/null

Ubuntu and Ubuntu-based distros:

sudo mkdir -p -m 0755 /usr/share/keyrings

curl -fsSL "https://pkgs.yeet.cx/ubuntu/yeet.noarmor.gpg" \
| sudo tee /usr/share/keyrings/yeet-archive-keyring.gpg >/dev/null

echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/yeet-archive-keyring.gpg] \
https://pkgs.yeet.cx/ubuntu $(. /etc/os-release; echo ${UBUNTU_CODENAME:-$VERSION_CODENAME}) stable" \
| sudo tee /etc/apt/sources.list.d/yeet.list >/dev/null

Then install yeet:

sudo apt-get update
sudo apt-get install -y yeet

DNF / RPM (Fedora, RHEL, and derivatives)

This covers Fedora, RHEL, Rocky Linux, AlmaLinux, Amazon Linux 2023, and similar RPM-based distros. Note that Amazon Linux 2 is not supported — use Amazon Linux 2023 or later.

Add the yeet repository and install:

Fedora:

sudo dnf install -y 'dnf-command(config-manager)'

curl -fsSL "https://pkgs.yeet.cx/fedora/yeet.repo" \
| sudo tee /etc/yum.repos.d/yeet.repo >/dev/null

sudo dnf install -y yeet
sudo systemctl enable --now yeetd

RHEL, Rocky Linux, AlmaLinux:

sudo dnf install -y 'dnf-command(config-manager)'

curl -fsSL "https://pkgs.yeet.cx/rhel/yeet.repo" \
| sudo tee /etc/yum.repos.d/yeet.repo >/dev/null

sudo dnf install -y yeet
sudo systemctl enable --now yeetd

Amazon Linux 2023:

sudo dnf install -y 'dnf-command(config-manager)'

VERSION_ID=$(. /etc/os-release; echo $VERSION_ID)
curl -fsSL "https://pkgs.yeet.cx/amzn/yeet.repo" \
| sed "s/\$releasever/$VERSION_ID/g" \
| sudo tee /etc/yum.repos.d/yeet.repo >/dev/null

sudo dnf install -y yeet
sudo systemctl enable --now yeetd

AUR (Arch Linux and derivatives)

yeet is published on the AUR as yeet-bin. This covers Arch Linux, Manjaro, Garuda, CachyOS, Artix, and other Arch-based distros.

If you have an AUR helper like yay installed, you can install yeet with a single command:

yay -S yeet-bin
sudo systemctl enable --now yeetd

If you'd prefer to install manually using makepkg:

tmp_dir=$(mktemp -d)

curl -fsSL "https://pkgs.yeet.cx/archlinux/yeet.noarmor.gpg" -o "$tmp_dir/yeet.pub"

gpg --import "$tmp_dir/yeet.pub"
key_id=$(gpg --with-colons --import-options show-only --import "$tmp_dir/yeet.pub" | awk -F: '/^pub/ {print $5}')
printf "5\ny\n" | gpg --command-fd 0 --edit-key "$key_id" -q trust

sudo pacman-key --add "$tmp_dir/yeet.pub"
sudo pacman-key --lsign-key "$key_id"

git clone -c init.defaultBranch=master https://aur.archlinux.org/yeet-bin.git "$tmp_dir/yeet-bin"
(cd "$tmp_dir/yeet-bin" && makepkg -s)
sudo pacman -U --noconfirm "$tmp_dir"/yeet-bin/yeet-bin-[0-9]*.pkg.tar.zst

sudo systemctl enable --now yeetd
rm -rf "$tmp_dir"

opkg (webOS)

mkdir -p /etc/opkg/keys
curl -fsSL "https://pkgs.yeet.cx/webos/yeet.pub" -o /etc/opkg/keys/yeet.pub

echo "src/gz yeet https://pkgs.yeet.cx/webos/$(. /etc/os-release; echo $VERSION_ID)/$(uname -m)/stable" \
| sudo tee /etc/opkg/yeet.conf >/dev/null

sudo opkg update
sudo opkg install yeet
sudo systemctl enable --now yeetd

Logging in

Once yeet is installed, authenticate with your account:

yeet login

This will give you a link to open in your browser. Once authenticated, you're ready to go.


Don't see your distro? Reach out to [email protected] and we'll help you out.