Install Paneflow on Linux

Paneflow provides Linux packages for x86_64 and ARM64 (aarch64). Choose the format for your distribution below. You do not need Rust or build tools to install these packages.

Choose an installation format

Run the download and installation commands in Bash, with curl installed, from the folder where you want to download the package. Each download block detects your processor architecture and fetches the latest release. Choose one format; you do not need to install all four.

How do I install Paneflow as an AppImage?

Use the AppImage to run Paneflow without installing a system package or using sudo. Download the file, make it executable, and launch it:

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

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

To use the paneflow command, move the AppImage into ~/.local/bin and rename it to paneflow:

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

If your shell cannot find the command, follow the PATH instructions below. If you still need to run without FUSE after moving the file, use ~/.local/bin/paneflow --appimage-extract-and-run. Paneflow stores its settings and workspace state in ~/.paneflow by default, separately from the AppImage. See the configuration guide.

How do I install Paneflow on Ubuntu or Debian?

Download the .deb for your processor and install it with 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/arthjean/paneflow/releases/latest | sed -nE 's/.*"tag_name": "v([^"]+)".*/\1/p')"
curl -fLO "https://github.com/arthjean/paneflow/releases/download/v${VERSION}/paneflow-${VERSION}-${ARCH}.deb"
sudo apt install "./paneflow-${VERSION}-${ARCH}.deb"

The package installs paneflow at /usr/bin/paneflow and registers the Paneflow package repository. For later updates, run sudo apt update, then sudo apt upgrade paneflow.

To uninstall, run sudo apt remove paneflow. Use sudo apt purge paneflow to also remove the Paneflow repository entry and signing key.

How do I install Paneflow on Fedora or openSUSE?

Download the .rpm for your processor. On Fedora, install it with dnf. On openSUSE, replace the final installation line as shown below before running the block:

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

On openSUSE, replace the final sudo dnf install line with:

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

The package registers the Paneflow RPM repository. For later updates, use sudo dnf upgrade paneflow on Fedora or sudo zypper update paneflow on openSUSE.

How do I install Paneflow from a tarball?

Use the .tar.gz archive for an installation in your home directory, including on Arch. Download and extract it, then run the included installer:

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

The installer copies the app to ~/.local/paneflow.app, creates the ~/.local/bin/paneflow symlink, and adds the application launcher and icons under ~/.local/share. Run it without sudo.

How do I verify the installation?

Open a terminal and run:

paneflow --version
paneflow

The first command should print the installed version. The second should open the Paneflow window. If the command is not found, follow the PATH instructions below. If the window does not open, follow the launch and graphics troubleshooting guide.

Once Paneflow opens, use the getting started guide to launch your first agent. Install CLI agents separately and follow their sign-in instructions.

What if paneflow is not found in my PATH?

The steps below apply to AppImage and .tar.gz installs. For a .deb or .rpm install, open a new terminal and run /usr/bin/paneflow --version. If that file is missing, reinstall the package.

If your shell reports command not found, first check that the file or symlink exists with ls -l ~/.local/bin/paneflow. If it is missing, repeat the AppImage move step or the .tar.gz installation above.

If the file exists but the command is not found, add ~/.local/bin to your shell's PATH. Run only the block for the shell you use, once:

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, consult the PATH troubleshooting guide.