Instalar Herdr

Herdr publica binarios del canal estable para Linux, macOS y Windows. Windows está disponible de forma general, con limitaciones propias de la plataforma documentadas y correcciones en curso.

Instalar

En Linux o macOS:

curl -fsSL https://herdr.dev/install.sh | sh

En Windows:

powershell -ExecutionPolicy Bypass -c "irm https://herdr.dev/install.ps1 | iex"

Si la seguridad del equipo bloquea ese comando de PowerShell sin fichero, abre el símbolo del sistema y ejecuta:

curl.exe -fsSLo install.cmd https://herdr.dev/install.cmd && install.cmd && del install.cmd

El instalador descarga el binario de tu plataforma y lo deja en el PATH. Las instalaciones directas nuevas usan el canal de actualización estable. Las instalaciones preliminares de Windows que ya existan siguen en preview hasta que las cambies con herdr channel set stable. En Windows, el PATH apunta al directorio de la versión activa; el instalador también actualiza los alias de compatibilidad current y bin del canal estable, así las actualizaciones no necesitan sobrescribir un herdr.exe en ejecución.

Instalar con Homebrew

Si ya usas Homebrew:

brew install herdr

Instalar con mise

Si ya usas mise:

mise use -g herdr

Si mise responde herdr not found in mise tool registry, actualiza mise y vuelve a intentarlo. Las versiones antiguas de mise son anteriores a la entrada de Herdr en su registro; mise use -g github:herdrdev/herdr sirve como alternativa temporal.

Instalar con Nix

Si ya usas Nix, Herdr ofrece un flake que compila Herdr desde el código fuente:

nix run github:herdrdev/herdr/v0.x.y
nix build github:herdrdev/herdr/v0.x.y
nix profile install github:herdrdev/herdr/v0.x.y

Sustituye v0.x.y por la última etiqueta de versión. Puedes omitir la etiqueta para seguir master, pero para una instalación normal se recomiendan las etiquetas de versión.

El flake también expone un entorno de desarrollo:

nix develop github:herdrdev/herdr

Para actualizar Herdr sigue el mismo flujo de Nix. Si lo instalaste en un perfil, lista las entradas del perfil y actualiza la de Herdr:

nix profile list
nix profile upgrade <índice-o-nombre>

Si Herdr es una entrada (input) de tu propio flake, actualízala y reconstruye el sistema, Home Manager o el entorno de desarrollo:

nix flake update herdr

Descargar a mano

También puedes descargar un binario desde las versiones publicadas en GitHub.

Elige el fichero que corresponda a tu sistema:

Sistema	Fichero
Linux x86_64	`herdr-linux-x86_64`
Linux aarch64	`herdr-linux-aarch64`
macOS Intel	`herdr-macos-x86_64`
macOS Apple silicon	`herdr-macos-aarch64`
Windows x86_64	`herdr-windows-x86_64.zip`

En Linux o macOS, dale permiso de ejecución y muévelo a algún directorio del PATH.

chmod +x herdr-linux-x86_64
mv herdr-linux-x86_64 ~/.local/bin/herdr

El archivo de Windows

Tanto las versiones estables como las preliminares incluyen herdr-windows-x86_64.zip. El archivo contiene herdr.exe y su runtime ConPTY local. Mantén junto el directorio descomprimido; no copies solo herdr.exe.

Comprobar

Arranca Herdr:

herdr

Si el shell no encuentra herdr, reinicia la terminal o comprueba que el directorio de instalación está en el PATH.

Actualizar

Herdr comprueba si hay versiones nuevas y te avisa dentro de la aplicación. Puedes actualizar a mano:

herdr update

Usa herdr update solo con instalaciones gestionadas por el instalador de Herdr. Las de Homebrew, mise y Nix se actualizan con su propio gestor de paquetes.

Las instalaciones directas en Linux, macOS y Windows usan por defecto el canal de actualización estable. Para pasarte a las versiones preliminares compiladas desde master, cambia de canal:

herdr channel set preview

Para volver una instalación directa al canal estable, lo mismo:

herdr channel set stable

En las instalaciones directas, cambiar de canal consulta el canal elegido e instala su último binario. Si esa actualización falla, ejecuta herdr update para reintentarlo desde el canal configurado.

Las versiones preliminares se publican con regularidad como prereleases de GitHub a partir de la rama de desarrollo. Sirven para tener correcciones antes de la siguiente versión estable, pero pueden traer regresiones. Las instalaciones de Homebrew, mise y Nix no usan el canal preliminar.

Para el uso normal en Windows se recomienda el canal estable. El preliminar recibe las correcciones antes pero puede fallar, así que pásate solo si quieres ese compromiso. Las instalaciones preliminares de Windows ya existentes siguen en preview hasta que las cambies expresamente. Si una versión preliminar antigua rechaza herdr channel set stable, ejecuta herdr update una vez en preview y vuelve a intentar el cambio de canal.

Por defecto, herdr update instala el binario nuevo y deja en marcha los servidores de generación 1 de puntos de acceso y los procesos de sus paneles. Vuelve a arrancar Herdr para conectarte con el cliente actualizado. Los cambios que solo afectan al cliente funcionan de inmediato. Una acción nueva del lado del servidor no está disponible hasta que ese servidor se actualice y reinicie; el cliente muestra un aviso en lugar de desconectarse. Los servidores anteriores a la generación 1 necesitan una última parada durante la actualización.

Para probar el traspaso en caliente experimental del servidor en las sesiones compatibles que estén en marcha:

herdr update --handoff

El traspaso en caliente no se aplica a las actualizaciones por Homebrew, mise ni Nix. En esas instalaciones, actualiza con el gestor de paquetes y vuelve a ejecutar Herdr para conectarte con el cliente actualizado. El servidor antiguo, si es compatible, sigue en marcha. Reinícialo más tarde con herdr server stop o herdr session stop <nombre> solo cuando quieras los cambios del lado del servidor de la versión nueva.

Requisitos

Hay binarios del canal estable para Linux, macOS y Windows x86_64. Consulta Windows para ver los flujos de trabajo compatibles y las limitaciones conocidas. Windows ARM64 ejecuta la compilación x86_64 mediante la emulación de Windows.