Archivos y carpetas
Dónde guarda Joppa su configuración, su CA, sus estadísticas y sus builds de PHP, y qué archivos escribe en tus proyectos.
La carpeta de Joppa
| Sistema | Ubicación |
|---|---|
| macOS | ~/Library/Application Support/joppa |
| Linux | ~/.config/joppa |
| Archivo o carpeta | Contenido |
|---|---|
config.json |
Proyectos, dominios, servicios y ajustes |
processes.json |
Procesos de los proyectos, cuando no están en un joppa.toml, y los de los entornos de worktrees |
team.json |
Para cada proyecto, el joppa.toml tal como esta máquina lo aplicó (o ignoró) por última vez: Joppa indica lo que un git pull cambia en él |
running.json |
Los servidores de desarrollo iniciados por Joppa que están en marcha, para encontrarlos si Joppa se cierra sin detenerlos |
control.json |
Puerto y token de la API local, para el comando joppa (legible solo por ti) |
reporter.json |
La dirección verificada para Informar de un error y su token, válido 30 días (legible solo por ti) |
telemetry.json |
Tus elecciones de Privacidad y el identificador aleatorio de las estadísticas |
crashes/ |
Los informes de fallos aún no enviados (solo con Enviar informes de fallos activado) |
logs/ |
Los registros de Joppa: joppa.log, y joppa.1.log a partir de 5 MB (legibles solo por ti) |
ca/ |
La autoridad de certificación: rootCA.pem y su clave rootCA-key.pem (solo lectura) |
snapshots/<volumen>/<base>/ |
Las instantáneas de las bases (Joppa Pro): un .dump (PostgreSQL) o un .sql.gz (MySQL, MariaDB) y un .json por instantánea; las más antiguas se eliminan por encima de Guardadas por base |
analytics/ |
Las estadísticas por dominio, una línea por minuto, guardadas 7 días |
php/<version>/ |
Los builds de PHP descargados |
php/xdebug/<8.x>/ |
Xdebug para una versión de PHP: xdebug.so, el xdebug.ini que lo carga y joppa.json (versión, suma de verificación) |
bin/ |
Los comandos php y composer que siguen .php-version |
share/cloudflared |
cloudflared, si se descargó con Descargar cloudflared para un enlace público (huella SHA-256 comprobada) |
share/known_hosts |
Las claves de host de localhost.run y Pinggy, para sus túneles ssh |
La licencia no está en esta carpeta: está en el llavero del sistema (servicio com.getjoppa.license), como el token de ngrok si se ha guardado (servicio com.getjoppa.ngrok).
En tus proyectos
Joppa solo escribe en un proyecto lo que tú has confirmado:
| Archivo | Cuándo |
|---|---|
.env |
Vinculación de un servicio, direcciones HTTPS, edición (siempre con un diff) |
.env.joppa-backup |
Copia del .env original, en la primera escritura (también en una migración) |
joppa.toml |
Si compartes la configuración del proyecto con el equipo (consulta joppa.toml) |
.node-version, package.json |
Si fijas Node o el gestor de paquetes |
.php-version |
Si fijas PHP |
.php.ini |
Si escribes el php.ini del proyecto |
vite.config.*, astro.config.* |
Si haces clic en Corregir el archivo |
En un worktree que Joppa prepara: los archivos .env, .env.local, .env.development(.local), .dev.vars y .php.ini que le faltan, copiados del proyecto con las direcciones del worktree. Nuevo worktree crea su carpeta junto al repositorio, en <proyecto>-worktrees/.
Fuera de estas carpetas
- Perfil del shell (
~/.zshrc…): solo los bloques# >>> Joppa (PHP) >>>y# >>> Joppa (Node) >>>, si los activas. - Vite+: instalado en el primer arranque en sus carpetas habituales (
~/.local/share/vite-plusy~/.config/vite-plus, o~/.vite-plussi ya estaba ahí), con Node LTS y bun. Joppa lo actualiza cada día. - Resolución de
.test: un archivo que envía*.testal servidor DNS de Joppa (127.0.0.1:15353), colocado con tu contraseña:/etc/resolver/testen macOS,/etc/systemd/resolved.conf.d/joppa.confo/etc/NetworkManager/dnsmasq.d/joppa.confen Linux. Empieza con una línea# Joppa. Consulta La resolución de los dominios .test. - Comando
joppa: un enlace en/usr/local/bino~/.local/bin, si lo instalas. - Asistentes: la entrada
mcpServers.joppaen su configuración, si los conectas. - Contenedores:
joppa-<motor>y sus volúmenesjoppa-<motor>-<version>en tu runtime.
Quitarlo todo
Ajustes › Desinstalar › Desinstalar Joppa… muestra lo que Joppa instaló en este equipo; marca lo que se elimina:
| Elemento | Qué se elimina |
|---|---|
| Servidor MCP de los asistentes | La entrada mcpServers.joppa de Claude Code, Claude Desktop y Cursor |
| Comando joppa | Los enlaces joppa en /usr/local/bin o ~/.local/bin |
| PHP y Node en el perfil del shell | Los bloques # >>> Joppa (PHP) >>> y # >>> Joppa (Node) >>> de ~/.zshrc, ~/.bash_profile, ~/.bashrc y joppa.fish |
| Contenedores de los servicios | Los contenedores joppa-<motor> y las imágenes que Joppa construyó para las extensiones |
| Datos de los servicios | Los volúmenes joppa-<motor>-<version>: bases de datos, correos, índices (sin marcar por defecto) |
| Aprobación de la CA | «Joppa local CA» eliminada de tu llavero de sesión (tu contraseña), o del llavero Sistema si el comando del terminal la puso ahí (contraseña de administrador) |
| Resolución de .test | El archivo de resolución de Joppa (/etc/resolver/test…), con tu contraseña. El de otra herramienta (Herd, Valet, dnsmasq) se queda |
| Licencia | El puesto de este Mac liberado y la clave eliminada del llavero |
| Carpeta de Joppa | La carpeta de arriba y los datos de la ventana (~/Library/WebKit/dev.joppa.app, cachés…) |
| La aplicación | Joppa.app (macOS) o el archivo .AppImage (Linux) |
La carpeta de Joppa y la app se eliminan una vez cerrado Joppa: el botón pasa a ser Desinstalar y salir. Los archivos de tus proyectos (.env, .env.joppa-backup, joppa.toml…) nunca se tocan.
Desde el terminal, joppa uninstall hace lo mismo: ver El comando joppa › Desinstalar.
Un paso que falla (contraseña cancelada, runtime detenido, sin red para liberar la licencia) se indica sin detener los demás. Para hacerlo a mano: docker rm -f joppa-postgres, docker volume rm joppa-postgres-17 y, en macOS, Acceso a Llaveros › Inicio de sesión (o Sistema) › «Joppa local CA».