Instalación

Descargar

Descarga la última versión desde la página de descarga:

Sistema	Archivo
macOS (Apple Silicon e Intel)	.dmg: arrastra Joppa a Aplicaciones
Linux x86_64	.AppImage (portable, hazlo ejecutable: chmod +x Joppa_amd64.AppImage) o .deb (Debian, Ubuntu: sudo apt install ./Joppa_amd64.deb)

Primera apertura en macOS

Joppa todavía no está firmado por Apple, así que macOS bloquea la primera apertura. Es normal, y solo lo pide una vez.

1. Abre Joppa desde Aplicaciones. macOS indica «No se ha abierto “Joppa”»: cierra el mensaje, sin elegir Trasladar a la papelera.
2. Abre Ajustes del Sistema › Privacidad y seguridad y baja hasta Seguridad.
3. Junto a «Se ha bloqueado “Joppa” para proteger tu Mac», haz clic en Abrir igualmente.
4. Confirma con Abrir igualmente y tu contraseña o Touch ID.

La página de descarga muestra estos pasos con imágenes.

En el primer arranque, Joppa crea su carpeta de configuración y su autoridad de certificación, e inicia el proxy HTTPS. Después vive en la barra de menús: cerrar la ventana no lo detiene.

Aprobar el certificado

Joppa firma un certificado para cada dominio con una autoridad de certificación local (CA). Para que el navegador muestre el candado, tu sistema debe confiar en esta autoridad. Solo hay que hacerlo una vez, con una contraseña de administrador.

Abre Ajustes › Autoridad de certificación: Joppa muestra el comando exacto para tu equipo, con un botón para copiarlo.

macOS

sudo security add-trusted-cert -d -r trustRoot -k /Library/Keychains/System.keychain \
  "$HOME/Library/Application Support/joppa/ca/rootCA.pem"

Joppa comprueba la confianza por sí mismo: la barra de estado pasa a CA ok en cuanto está hecho.

Linux

sudo cp ~/.config/joppa/ca/rootCA.pem /usr/local/share/ca-certificates/joppa-rootCA.crt
sudo update-ca-certificates

Los puertos 80 y 443

El proxy escucha en 127.0.0.1, puerto 443 (HTTPS) y 80 (redirección a HTTPS). Solo acepta conexiones de tu equipo.

• macOS: no hay que hacer nada.
• Linux: los puertos por debajo de 1024 requieren un permiso especial. Si Joppa no puede abrirlos, muestra el comando que debes ejecutar:

sudo setcap cap_net_bind_service=+ep /ruta/a/joppa

Si solo el puerto 80 no está disponible, el proxy funciona igualmente; simplemente se desactiva la redirección HTTP → HTTPS.

La resolución de los dominios .test

El navegador tiene que saber que miproyecto.test apunta a tu equipo (127.0.0.1). Joppa no modifica tu configuración DNS: si un dominio no responde aunque el proxy esté en marcha, haz que *.test se resuelva a 127.0.0.1.

En macOS, con dnsmasq (Homebrew):

brew install dnsmasq
echo 'address=/.test/127.0.0.1' >> "$(brew --prefix)/etc/dnsmasq.conf"
sudo brew services start dnsmasq
sudo mkdir -p /etc/resolver
echo 'nameserver 127.0.0.1' | sudo tee /etc/resolver/test

Un runtime de contenedores (opcional)

Los dominios y el HTTPS no necesitan nada más. Para los servicios (PostgreSQL, Redis, Mailpit…), instala uno de estos runtimes: OrbStack, Docker Desktop, Colima o Podman. Consulta Runtimes de contenedores.

Comprobar

La barra de estado de la parte inferior de la ventana lo resume todo:

joppa   proxy :443   CA joppa ok   2/2 dominios en línea   1/1 servicio

Ya puedes pasar a los primeros pasos.