Introducción
Joppa da a cada proyecto local un dominio .test, un certificado de confianza y sus bases de datos. Esta documentación explica todo lo que hace, y cómo.
Joppa es una app de escritorio para macOS y Linux que sustituye la configuración de tu entorno de desarrollo local. Le das una carpeta; encuentra los servidores de desarrollo que se ejecutan en ella, les da una dirección https:// que se parece a la de producción y pone en marcha las bases de datos que el proyecto necesita.
localhost:5173 → https://app.kinosante.test 🔒
localhost:8000 → https://api.kinosante.test 🔒
postgres (contenedor) → 127.0.0.1:5432 · base kinosante · pgvector
Por dónde empezar
InstalaciónDescargar Joppa, aprobar el certificado y hacer que se resuelvan los dominios .test.
Primeros pasosTu primer proyecto en HTTPS, en cinco minutos.
ConceptosProyecto, dominio, proxy, servicio: el vocabulario de Joppa.
Atajos de tecladoToda la app se maneja con el teclado, empezando por ⌘K.
Qué hace Joppa
Para tus proyectos

- Dominios
.testen HTTPS: un dominio por servidor de desarrollo (app.miproyecto.test,api.miproyecto.test), con un certificado de confianza. - Procesos: Joppa inicia tus servidores de desarrollo y tus contenedores de Compose en el orden correcto, con una terminal integrada y reinicio tras un fallo.
- Variables de entorno: el
.envse mantiene al día con los dominios y los servicios, siempre con un diff antes de escribir. - Versiones de Node, bun y PHP fijadas por proyecto.
- Analytics: peticiones, latencia, errores y disponibilidad de tus servidores de desarrollo.
- Nuevo proyecto desde una plantilla: Vite+, Next.js, Nuxt, Astro, SvelteKit, Laravel o un repositorio de GitHub.
Para tus servicios
- Bases de datos: PostgreSQL (con pgvector, PostGIS…), MySQL y MariaDB, una base de datos por proyecto.
- Caché, correo y búsqueda: Redis, Valkey, Mailpit, Typesense y Meilisearch.
- Importación desde Docker Compose: tus datos copiados en Joppa, sin tocar el origen.
En todas partes
- El comando
joppa, una app a pantalla completa en la terminal y un servidor MCP para Claude y Cursor. - La paleta ⌘K y un atajo para cada acción.
Sistemas compatibles
| Sistema | Estado |
|---|---|
| macOS | Disponible (Apple Silicon e Intel) |
| Linux | Disponible (.AppImage y .deb) |
| Windows | En desarrollo |
Joppa es gratis hasta 3 proyectos y 1 servicio. Joppa Pro elimina estos límites.