Saltar al contenido
PaneflowPaneflow

Instalar Paneflow en Linux

Instala Paneflow en Ubuntu, Debian, Fedora, openSUSE, Arch o cualquier Linux moderno con AppImage, .deb, .rpm o tarball.

Paneflow publica cuatro formatos de Linux para x86_64 y aarch64. Usa el AppImage si quieres el camino más rápido, el paquete de sistema para tu distribución, o el tarball cuando necesitas una instalación local y scriptable.

DistribuciónRuta recomendadaActualizaciones
Cualquier Linux modernoAppImageActualización AppImage dentro de la app
Ubuntu, Debian.debapt upgrade paneflow tras la primera instalación
Fedora, openSUSE.rpmdnf upgrade paneflow o zypper update paneflow tras la primera instalación
Arch, instalaciones personalizadas, imágenes CI.tar.gzSustituir por un tarball más reciente

Paneflow necesita Vulkan. Los paquetes de sistema declaran las dependencias GUI comunes y el cargador de Vulkan, pero tu máquina sigue necesitando un driver de GPU funcional. Para AppImage y tarball, asegúrate de que tu distribución tenga instalado el cargador Vulkan: libvulkan1 en la familia Debian, vulkan-loader en Fedora y vulkan-icd-loader en Arch.

¿Cómo instalo Paneflow como AppImage?

El AppImage es la descarga Linux por defecto: sin root, sin gestor de paquetes y sin escribir archivos fuera del directorio donde lo dejas.

bash
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"

Para lanzarlo desde cualquier terminal, muévelo a ~/.local/bin:

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

Ubuntu 24.04 y otras distribuciones recientes ya no instalan FUSE 2 por defecto. Si el AppImage falla con dlopen(): error loading libfuse.so.2, ejecútalo con el fallback extract-and-run:

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

En Ubuntu, también puedes instalar FUSE 2 una vez con sudo apt install libfuse2t64.

¿Cómo instalo Paneflow en Ubuntu o Debian?

Descarga el último .deb para tu arquitectura de CPU e instálalo con apt. La primera instalación también registra el repositorio de paquetes de Paneflow, así que las siguientes actualizaciones pueden llegar por apt.

bash
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"

El binario queda instalado en /usr/bin/paneflow. Elimina Paneflow con sudo apt remove paneflow. Usa sudo apt purge paneflow si también quieres eliminar la fuente apt de Paneflow y su keyring.

¿Cómo instalo Paneflow en Fedora u openSUSE?

Descarga el último .rpm e instálalo con el gestor de paquetes de tu distribución. La primera instalación también registra el repositorio RPM de Paneflow para actualizaciones posteriores.

bash
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"

En openSUSE, usa zypper para la última línea:

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

¿Cómo instalo Paneflow desde un tarball?

Usa el tarball para Arch, imágenes CI o instalaciones locales donde no quieres un paquete de sistema. El tarball extrae una carpeta paneflow.app/ con bin/paneflow, metadatos de escritorio, iconos y un script de instalación.

bash
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

El instalador escribe en ~/.local/paneflow.app, crea el symlink ~/.local/bin/paneflow e instala archivos de escritorio en ~/.local/share. No usa sudo.

¿Cómo verifico la instalación?

Ejecuta:

bash
paneflow --version
paneflow

Si paneflow --version imprime una versión y paneflow abre el workspace, la instalación funcionó. El primer inicio abre un workspace vacío con un solo panel shell. Pulsa Ctrl+Shift+D para dividir en horizontal o Ctrl+Shift+E para dividir en vertical.

Siguientes pasos: lee el tour de funciones, abre la guía de configuración, o usa solución de problemas para Vulkan, Wayland y problemas de PATH.

¿Qué pasa si paneflow no está en mi PATH?

Si paneflow --version devuelve command not found, el binario no está en el PATH de tu shell. Esto suele pasar tras una instalación AppImage o tarball cuando ~/.local/bin no se carga al iniciar la shell.

Añádelo una vez para tu shell:

bash (~/.bashrc):

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

zsh (~/.zshrc):

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

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

fish
fish_add_path ~/.local/bin

Abre un terminal nuevo y vuelve a ejecutar paneflow --version. Si sigue fallando, confirma que el symlink existe con ls -l ~/.local/bin/paneflow.