Install Paneflow on Linux

Paneflow ships four Linux formats for x86_64 and aarch64. Use the AppImage if you want the fastest path, the system package for your distribution, or the tarball when you need a user-local scripted install.

How do I install Paneflow as an AppImage?

The AppImage is the default Linux download: no root, no package manager, and no files written outside the directory where you place it.

ARCH="$(uname -m)"
[ "$ARCH" = "arm64" ] && ARCH="aarch64"
VERSION="$(curl -fsSL https://api.github.com/repos/ArthurDEV44/paneflow/releases/latest | sed -nE 's/.*"tag_name": "v([^"]+)".*/\1/p')"
curl -fLO "https://github.com/ArthurDEV44/paneflow/releases/download/v${VERSION}/paneflow-${VERSION}-${ARCH}.AppImage"
chmod +x "paneflow-${VERSION}-${ARCH}.AppImage"
./"paneflow-${VERSION}-${ARCH}.AppImage"

To launch it from any terminal, move it into ~/.local/bin:

mkdir -p ~/.local/bin
mv "paneflow-${VERSION}-${ARCH}.AppImage" ~/.local/bin/paneflow
chmod +x ~/.local/bin/paneflow

./"paneflow-${VERSION}-${ARCH}.AppImage" --appimage-extract-and-run

How do I install Paneflow on Ubuntu or Debian?

Download the latest .deb for your CPU architecture and install it with apt. The first install also registers the Paneflow package repository, so later updates can come through apt.

DEB_ARCH="$(dpkg --print-architecture)"
case "$DEB_ARCH" in
  amd64) ARCH="x86_64" ;;
  arm64) ARCH="aarch64" ;;
  *) echo "Unsupported architecture: $DEB_ARCH" >&2; exit 1 ;;
esac
VERSION="$(curl -fsSL https://api.github.com/repos/ArthurDEV44/paneflow/releases/latest | sed -nE 's/.*"tag_name": "v([^"]+)".*/\1/p')"
curl -fLO "https://github.com/ArthurDEV44/paneflow/releases/download/v${VERSION}/paneflow-${VERSION}-${ARCH}.deb"
sudo apt install "./paneflow-${VERSION}-${ARCH}.deb"

The binary is installed at /usr/bin/paneflow. Remove Paneflow with sudo apt remove paneflow. Use sudo apt purge paneflow if you also want to remove the Paneflow apt source and keyring.

How do I install Paneflow on Fedora or openSUSE?

Download the latest .rpm and install it with your distribution package manager. The first install also registers the Paneflow RPM repository for later updates.

ARCH="$(uname -m)"
[ "$ARCH" = "arm64" ] && ARCH="aarch64"
VERSION="$(curl -fsSL https://api.github.com/repos/ArthurDEV44/paneflow/releases/latest | sed -nE 's/.*"tag_name": "v([^"]+)".*/\1/p')"
curl -fLO "https://github.com/ArthurDEV44/paneflow/releases/download/v${VERSION}/paneflow-${VERSION}-${ARCH}.rpm"
sudo dnf install "./paneflow-${VERSION}-${ARCH}.rpm"

On openSUSE, use zypper for the final line:

sudo zypper install "./paneflow-${VERSION}-${ARCH}.rpm"

How do I install Paneflow from a tarball?

Use the tarball for Arch, CI images, or user-local installs where you do not want a system package. The tarball extracts a paneflow.app/ folder with bin/paneflow, desktop metadata, icons, and an installer script.

ARCH="$(uname -m)"
[ "$ARCH" = "arm64" ] && ARCH="aarch64"
VERSION="$(curl -fsSL https://api.github.com/repos/ArthurDEV44/paneflow/releases/latest | sed -nE 's/.*"tag_name": "v([^"]+)".*/\1/p')"
curl -fLO "https://github.com/ArthurDEV44/paneflow/releases/download/v${VERSION}/paneflow-${VERSION}-${ARCH}.tar.gz"
tar -xzf "paneflow-${VERSION}-${ARCH}.tar.gz"
cd paneflow.app
./install.sh

The installer writes to ~/.local/paneflow.app, creates the ~/.local/bin/paneflow symlink, and installs desktop files under ~/.local/share. It does not use sudo.

How do I verify the installation?

Run:

paneflow --version
paneflow

If paneflow --version prints a version and paneflow opens the workspace, the install worked. The first run opens an empty workspace with one shell pane. Press Ctrl+Shift+D to split horizontally or Ctrl+Shift+E to split vertically.

Next steps: read the features tour, open the configuration guide, or use troubleshooting for Vulkan, Wayland, and PATH issues.

What if paneflow is not found in my PATH?

If paneflow --version returns command not found, the binary is not on your shell's PATH. This usually happens after an AppImage or tarball install when ~/.local/bin is not part of your shell startup.

Add it once for your shell:

bash (~/.bashrc):

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

zsh (~/.zshrc):

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

fish (~/.config/fish/config.fish):

fish_add_path ~/.local/bin

Open a new terminal and run paneflow --version again. If it still fails, confirm the symlink exists with ls -l ~/.local/bin/paneflow.