Revisar el estado del sistema
Buena parte de los problemas raros del framework —imágenes que no suben, páginas que no se generan, paquetes que no se descargan— son en realidad el mismo problema: el sistema no tiene permiso para escribir en alguna carpeta.
Para eso existe Configuración → Estado del Sistema. Es la primera pantalla que deberías abrir cuando algo dejó de funcionar sin explicación.
Antes de revisar configuraciones o pedir ayuda, abre esta pantalla. Si todo sale en verde, el problema es otro y te ahorras buscar donde no es.
Qué revisa
Estado del Sistema: cada directorio con su dueño y su estado. Las filas sin permiso muestran el comando exacto para repararlas.
La pantalla comprueba, una por una, las carpetas donde el sistema necesita escribir:
| Carpeta | Para qué se usa | Qué falla si no es escribible |
|---|---|---|
| Páginas web generadas | Guardar las páginas públicas que creas | El generador de páginas no guarda |
| Archivos subidos | Imágenes y adjuntos de tus registros | No puedes subir imágenes ni archivos |
| Registros (logs) | Historial técnico de lo que ocurre | Se pierde el rastro para diagnosticar |
| Temporales de la API | Trabajo intermedio de la API | Fallan operaciones sueltas, sin patrón claro |
| Paquetes exportados | Los ZIP que genera el empaquetado | No puedes empaquetar la instalación |
| Sitemap | El archivo que leen los buscadores | No se actualiza el sitemap |
| Páginas de módulos y plugins | Crear la pantalla de una sección o de un módulo recién activado | La sección aparece en el menú pero al abrirla dice "Página no disponible" |
Cada fila muestra el estado (Escribible, Sin permiso o No existe) y, cuando corresponde, quién es el dueño actual de la carpeta.
Los dos botones
Verificar vuelve a comprobar todo. No cambia nada; úsalo después de arreglar algo para confirmar que quedó bien.
Intentar reparar es el que resuelve la mayoría de los casos: crea las carpetas que falten y ajusta los permisos de las que el sistema ya controla.
Direcciones de las fotos
Más abajo hay una tarjeta aparte que no mira permisos sino dónde busca el sistema las fotos que subieron los módulos.
Cada foto se guarda con una dirección relativa a la raíz de tu dominio, así que
arrastra la carpeta desde la que se servía la instalación que la subió. Si armas
el sitio en midominio.cl/pruebas/sistema y lo publicas en la raíz de
otrodominio.cl, la base sigue pidiendo /pruebas/sistema/cms/views/... y el
archivo vive en /cms/views/...: existe, y no se encuentra. Es el caso más
desconcertante, porque en el panel todo se ve bien.
No tienes que saber nada de eso. La tarjeta lo averigua sola, en tres pasos:
- Mira desde dónde se sirve este sitio (lo dice arriba, junto al título).
- Recorre la base de datos y junta todas las carpetas desde las que se están pidiendo fotos.
- Por cada una abre el archivo en el servidor para saber si está ahí. Eso es lo que decide: una carpeta distinta no prueba nada por sí sola.
Después te muestra una fila por carpeta con lo que encontró:
| Estado | Qué significa | Qué hacer |
|---|---|---|
| Correcta | El archivo está donde el sistema lo busca. | Nada. |
| Se puede arreglar | El archivo está en el servidor, pero se pide desde otra carpeta. | Pulsa Arreglar las direcciones. |
| Falta el archivo | La dirección es la correcta y la foto no está. | Vuelve a subir esa foto. |
| No está el archivo | Se pide desde otra carpeta y ahí tampoco está. | Vuelve a subirla. |
| Necesita una mano | Las fotos se guardaron en la raíz del dominio y este sitio vive en una subcarpeta. | Ver el aviso de abajo. |
Arreglar las direcciones reescribe de una vez todas las que dicen «se puede arreglar» —los archivos no se tocan—, lo anota en el registro de actividad y vacía la caché del sitio público. El botón queda apagado cuando no hay nada que corregir.
Si las fotos se guardaron en la raíz del dominio y hoy el sitio vive en una
subcarpeta, la corrección no se puede hacer sola: no hay carpeta que buscar,
sólo /cms/views/, que también aparece dentro de las direcciones que ya están
bien — reescribirlas duplicaría el prefijo. Lo resuelve quien administra el
servidor, o volver a publicar el sitio en la raíz del dominio.
Cuando "Intentar reparar" no basta
Hay un límite real: cambiar el dueño de una carpeta requiere permisos de administrador del servidor, y el sistema no los tiene. Cuando una carpeta pertenece a otro usuario, la pantalla no puede arreglarla sola.
En ese caso muestra, en esa misma fila, el comando exacto que hay que ejecutar, con un botón para copiarlo. Se ve así:
sudo chown -R www-data /ruta/de/la/carpeta && sudo chmod -R 755 /ruta/de/la/carpeta
Si no tienes acceso al servidor, cópialo y entrégaselo tal cual a tu proveedor de hosting o a quien te administre el servidor. No hay que interpretarlo ni adaptarlo: es la instrucción completa.
El aviso menciona bajo qué usuario corre el servidor web (www-data, daemon, _www,
según el sistema). Ese es el usuario que necesita permiso, no tu usuario de la máquina.
Quién puede entrar
Solo los roles superadmin y admin. Un usuario operativo no ve esta sección, y es a propósito: los comandos que muestra afectan al servidor completo.
¿Qué sigue?
- Problemas frecuentes del sitio público — imágenes rotas, datos viejos.
- Errores comunes al instalar — cuando falla desde el principio.
- Pedir ayuda — qué información entregar para que te ayuden rápido.