Nuevos documentos de Zima: desde la configuración de ZimaOS hasta las aplicaciones, el hardware, las herramientas para desarrolladores y la comunidad

Un servidor doméstico rara vez permanece igual que el primer día. Empiezas conectando el sistema, luego añades almacenamiento, transfieres tus archivos, instalas algunas aplicaciones, experimentas con el acceso remoto y, con el tiempo, acabas comparando niveles RAID, ejecutando Jellyfin, haciendo copias de seguridad de tus fotos, probando la IA local o leyendo sobre ZFS un domingo por la noche.

Por eso hemos rediseñado la documentación de ZimaSpace en torno a las cosas que las personas realmente intentan hacer. En lugar de tratar la documentación como un manual interminable, la nueva estructura te ofrece cinco rutas de aprendizaje claras: ZimaOS, Tienda de aplicaciones, Hardware, Desarrollo y Centro de ayuda. Y cuando la ruta documentada no es suficiente, la Comunidad de ZimaSpace te ofrece otro lugar para comparar configuraciones, hacer preguntas, compartir soluciones y ver qué están creando otros usuarios.

Para la mayoría de los usuarios nuevos, el recorrido comienza naturalmente con ZimaOS, pasa a las aplicaciones cuando lo básico ya funciona y se ramifica hacia el hardware o las herramientas para desarrolladores a medida que la configuración se vuelve más ambiciosa. Pero no hay un orden obligatorio: si estás aquí por Jellyfin, ve directamente a la Tienda de aplicaciones; si necesitas ZFS o SSH, dirígete a Desarrollo; si algo ya ha dejado de funcionar, empieza por el Centro de ayuda; y si tu configuración no coincide del todo con una guía formal, Comunidad suele ser el siguiente lugar que conviene consultar.

1. ZimaOS: empieza por los cimientos

La documentación de ZimaOS es el mejor punto de partida si tu pregunta principal es cómo hacer que el sistema operativo, el almacenamiento, los datos, las copias de seguridad y el acceso diario funcionen correctamente.

Esta sección de la documentación sigue el ciclo de vida natural de un servidor doméstico en lugar de tratar cada función como un tutorial aislado: poner en marcha el sistema, organizar el almacenamiento, incorporar tus datos, hacer que sean accesibles y aprender después a mantener el servidor.

Descripción general

La descripción general de ZimaOS sirve como entrada a toda la sección. Si aún no tienes claro qué guía necesitas, empieza aquí. Conecta la configuración, el almacenamiento, las copias de seguridad, el uso compartido de archivos, la instalación y la gestión del sistema para que puedas avanzar rápidamente hacia el problema que realmente intentas resolver.

Para un sistema completamente nuevo, la guía Primeros pasos con ZimaOS es la ruta más directa. Explica la primera conexión, ZimaClient, la creación de la cuenta y el entorno básico que usarás después.

Configuración y almacenamiento

Si el servidor es nuevo, dedica un poco de tiempo a esta sección antes de instalar diez aplicaciones solo porque parecen interesantes.

Configuración y almacenamiento aborda las decisiones que luego son más difíciles de cambiar: entender la interfaz de ZimaOS, elegir unidades, crear almacenamiento, comparar las opciones de RAID y decidir dónde deben residir los datos de las aplicaciones.

La guía de configuración del almacenamiento de ZimaOS resulta especialmente útil si estás decidiendo entre un sistema sencillo con un solo disco, almacenamiento redundante para archivos importantes, una biblioteca multimedia más grande o almacenamiento para un servidor doméstico siempre encendido.

Configurar correctamente la distribución del almacenamiento desde el principio facilita casi todo lo que viene después.

Sincronización y copias de seguridad

Una vez que el servidor está funcionando, la siguiente pregunta normalmente no trata sobre el servidor en sí. Trata sobre tus datos: ¿cómo paso realmente todas mis cosas a él?

Sincronización y copias de seguridad reúne esas rutas de migración. Esta sección de la documentación cubre las copias de seguridad del teléfono y del ordenador, las conexiones a unidades en la nube, el traslado de datos desde otro NAS, la transferencia de archivos entre unidades, Time Machine y los flujos de trabajo generales de copia de seguridad.

Las fotos suelen ser uno de los primeros conjuntos grandes de datos personales que la gente traslada a un servidor doméstico. Si quieres crear una biblioteca privada de fotos, la guía de copias de seguridad de fotos con Immich te ofrece una forma práctica de empezar a hacer copias de seguridad y gestionar fotos en ZimaOS.

Tanto si vas a mover unos cientos de fotos del teléfono como si vas a sustituir gradualmente un NAS antiguo o un flujo de trabajo de almacenamiento en la nube, no necesitas migrarlo todo en un fin de semana. Mueve una fuente cada vez y crea el sistema de copias de seguridad en torno a los datos que realmente te importan.

Acceso y uso compartido

Un NAS al que solo se puede acceder mientras estás sentado a su lado no resulta especialmente emocionante.

Acceso y uso compartido es donde ZimaOS empieza a conectar el servidor con el resto de tus dispositivos. La sección cubre ZimaClient, el acceso remoto, el uso compartido de archivos SMB, los enlaces compartidos y las configuraciones de Samba para varios usuarios.

Si vas a conectar un ordenador o un teléfono por primera vez, la guía de instalación de ZimaClient es un buen punto de partida.

A partir de ahí, piensa en el acceso según la situación: compartir archivos localmente con los ordenadores de la casa, acceder de forma remota cuando estés fuera o compartir herramientas cuando otra persona solo necesite determinados archivos o carpetas.

Métodos de instalación

ZimaOS no se limita a un único método de instalación.

Si vas a instalar el sistema por tu cuenta, la guía Cómo instalar ZimaOS explica cómo crear medios de instalación, arrancar el dispositivo, instalar el sistema operativo y acceder al sistema después.

Esta sección resulta especialmente útil para quienes construyen servidores domésticos DIY con hardware x86-64 compatible, así como para usuarios que experimentan con Proxmox, migran desde CasaOS o realizan otras tareas relacionadas con la instalación y las cuentas.

Sistema

Probablemente no abrirás la sección Sistema todos los días. Y eso es algo bueno.

Cuando un servidor pasa a formar parte de tu flujo de trabajo diario, la fiabilidad importa más que la configuración. La sección Sistema cubre el lado menos glamuroso, pero importante, de ejecutar ZimaOS, incluida la protección eléctrica, la recuperación, la instalación sin conexión, los restablecimientos de red, la búsqueda y otras tareas de mantenimiento.

No necesariamente serán las primeras guías que leas, pero quizá te alegres de saber que existen antes del día en que realmente las necesites.

2. Tienda de aplicaciones: decide qué quieres que haga tu servidor

Poner el almacenamiento en línea resulta satisfactorio. Instalar la primera aplicación útil suele ser el momento en que un servidor doméstico empieza a sentirse como tu servidor doméstico.

La documentación de la tienda de aplicaciones de ZimaOS está organizada en torno a las cargas de trabajo y no a los mecanismos de instalación.

En lugar de empezar con la pregunta «¿Cómo configuro Docker?», esta parte del mapa de aprendizaje comienza en un punto más útil: ¿Qué quieres que haga tu servidor?

Servidor multimedia

Este es uno de los puntos más fáciles para empezar con el autoalojamiento. Un servidor doméstico puede convertirse en una biblioteca privada de películas, televisión, música, fotos y otros contenidos multimedia que permanecen bajo tu control.

La sección Servidor multimedia reúne Jellyfin, Plex, Emby, Immich, servicios DLNA, servidores de cámaras, migración de fotos y cargas de trabajo multimedia asistidas por GPU.

Si Jellyfin es tu primer proyecto de servidor, la guía para configurar un servidor multimedia Jellyfin ofrece una ruta directa para crear una biblioteca privada de streaming.

Si tu primera idea para un servidor doméstico suena más a «Quiero mi propio Netflix» o «Quiero sacar mis fotos de una suscripción en la nube», esta es la parte de la documentación que debes explorar primero.

Aplicaciones autoalojadas

Después del servidor multimedia viene la parte peligrosa: darte cuenta de que puedes alojar por tu cuenta casi cualquier cosa.

Esta sección abarca herramientas para sincronizar archivos, bloquear anuncios en toda la red, gestionar documentos, automatizar descargas, supervisar sistemas, gestionar contenido multimedia y otros servicios que normalmente estarían en algún lugar de la nube.

No necesitas tener veinte contenedores desde el primer día. Elige un problema que quieras que tu servidor resuelva, haz que ese flujo de trabajo funcione y después añade el siguiente servicio.

IA y aprendizaje automático

La IA local se ha convertido rápidamente en otra razón para mantener un servidor potente funcionando en casa.

La sección IA y aprendizaje automático se centra en cargas de trabajo en las que los modelos, documentos, fotos o agentes pueden ejecutarse cerca de tus propios datos. La ruta de aprendizaje incluye la implementación de modelos locales, la búsqueda con IA, modelos sin conexión, inteligencia para fotos y agentes de IA siempre activos.

Si te interesan la IA privada, los LLM locales o los agentes que necesitan acceso continuo a archivos almacenados en tu servidor, esta es la sección que debes seguir.

Proyectos creativos

No todos los proyectos de servidores domésticos tienen que mejorar la productividad. A veces simplemente quieres construir algo porque puedes hacerlo.

Creative Builds reúne proyectos más experimentales, como servidores de juegos, gaming retro, configuraciones relacionadas con la realidad virtual, experimentos de virtualización, tiendas de aplicaciones comunitarias y otros proyectos que se sitúan en algún punto entre un laboratorio doméstico y un pasatiempo de fin de semana.

Para los usuarios de laboratorios domésticos, este suele ser el punto en el que un proyecto se convierte silenciosamente en tres más.

Recursos para desarrolladores

Con el tiempo, algunos usuarios se encuentran con el mismo problema: la aplicación que quieren todavía no existe en la tienda.

Recursos para desarrolladores ofrece el siguiente paso a quienes quieren crear y publicar aplicaciones por su cuenta, tendiendo un puente natural entre usar la App Store y contribuir al ecosistema que la sustenta.

3. Hardware: entiende la máquina que hay debajo del software

Las guías de software responden muchas preguntas hasta que la pregunta pasa a ser «¿Cuál es ese puerto?» o «¿Puede este equipo admitir otra unidad, una NIC, una GPU u otro sistema operativo?».

Ahí es donde entra la documentación del hardware.

Descripción general

La vista general del hardware reúne las principales familias de dispositivos Zima y te ofrece una forma rápida de entender qué ruta de documentación corresponde al hardware que tienes delante.

ZimaCube está diseñado para cargas de trabajo centradas en NAS, almacenamiento, multimedia y expansión de mayor escala. ZimaBoard encaja en servidores domésticos compactos, redes, autoalojamiento y experimentación con hardware. ZimaBlade ofrece un punto de entrada más pequeño para proyectos de NAS y servidores DIY.

Cuando sepas con qué familia estás trabajando, el resto de la sección Hardware será mucho más fácil de recorrer.

ZimaCube

La ruta de ZimaCube está pensada para usuarios que trabajan con un NAS más grande y un sistema centrado en la expansión.

Sus guías van más allá de la configuración inicial e incluyen interfaces de hardware, almacenamiento adicional, expansión mediante GPU, expansión mediante SSD, configuración de la BIOS, redes, Thunderbolt, refrigeración, Wake-on-LAN y otras funciones específicas del dispositivo.

Usa esta sección cuando la pregunta ya no sea simplemente «¿Cómo uso ZimaOS?», sino «¿Qué puede hacer esta configuración de hardware en particular?».

ZimaBoard 2

ZimaBoard 2 es la rama compacta y orientada a la expansión del mapa de hardware. Está diseñada para usuarios a quienes les gusta experimentar con servidores domésticos, redes, autoalojamiento, almacenamiento y configuraciones de hardware personalizadas.

Si acabas de sacar la placa de la caja, empieza con la guía de inicio de ZimaBoard 2. Ofrece un punto de partida claro para el recorrido por el hardware antes de adentrarte en el almacenamiento, las redes, las aplicaciones, la refrigeración o la expansión PCIe.

A partir de ahí, la documentación de ZimaBoard abarca las interfaces de hardware, los pasos para encenderla, la expansión, la refrigeración, la configuración de ventiladores PWM y detalles prácticos para integrar la placa en un proyecto de homelab más grande.

Eso hace que la misma placa sea adecuada para usos muy diferentes: un NAS compacto, un servidor multimedia, un host de Docker, un dispositivo de red, un nodo de virtualización u otro servicio autoalojado siempre activo.

ZimaBlade

ZimaBlade simplifica el recorrido del hardware y ofrece un punto de entrada accesible a los servidores DIY.

Su documentación se centra principalmente en poner en funcionamiento el hardware, comprender la configuración básica y preparar el sistema antes de comenzar a añadir aplicaciones y servicios.

Compatibilidad

Los servidores domésticos rara vez existen por sí solos. Las unidades, los SAI, los adaptadores de red, los módulos Wi‑Fi, las tarjetas de expansión y otros accesorios se convierten gradualmente en parte del sistema.

La sección de compatibilidad responde a la pregunta práctica de qué se ha probado y cómo debe configurarse un hardware específico.

Su función es muy sencilla: ayudar a responder «¿Funciona con mi configuración?» antes de que pases una tarde preguntándote por qué no funciona.

Sistemas de terceros

El hardware Zima no está limitado a un solo sistema operativo.

Si tu proyecto requiere Unraid, TrueNAS, OpenWrt, OpenMediaVault, Ubuntu Server, Arch Linux u otro entorno, la sección de sistemas de terceros ofrece un camino hacia implementaciones alternativas.

Esto significa que la documentación del hardware sigue siendo útil incluso cuando tu proyecto acaba creciendo más allá del propio ZimaOS.

4. Desarrolladores: profundiza cuando los valores predeterminados ya no sean suficientes

La mayoría de las personas no necesita empezar aquí, y ese es precisamente el objetivo.

La documentación para desarrolladores está pensada para el momento en que los valores predeterminados dejan de ser suficientes y quieres tener más control sobre el sistema subyacente.

Descripción general

La descripción general para desarrolladores es la rama avanzada del mapa de aprendizaje para usuarios avanzados, creadores de homelabs, desarrolladores y cualquiera que quiera profundizar más allá de la interfaz estándar de ZimaOS.

Si ya sabes lo que buscas —ZFS, SSH, API, aplicaciones personalizadas o redes más avanzadas—, no necesitas seguir primero las guías para principiantes. Empieza aquí.

Almacenamiento y sistemas de archivos

Esta sección va más allá de la configuración cotidiana de discos y aborda tecnologías como ZFS, configuraciones RAID avanzadas, NFS, iSCSI, almacenamiento cifrado, rsync, flujos de recuperación y conexiones con otros sistemas NAS.

Si Configuración y almacenamiento, en la sección de ZimaOS, responde a «¿Cómo debo configurar mis unidades?», la sección de almacenamiento para desarrolladores comienza a responder a otra pregunta: «¿Cómo funciona la pila de almacenamiento y cuánto control puedo tener sobre ella?».

Redes y protocolos

A medida que crece un homelab, las redes pasan a formar parte del proyecto en lugar de ser algo que simplemente ocurre en segundo plano.

Redes y protocolos abarca la configuración de red, el acceso SSH, los ajustes avanzados de SSH, el rendimiento de las transferencias y los protocolos utilizados para conectar ZimaOS con otras máquinas.

Esta es la siguiente parada natural cuando empiezas a trabajar con varios servidores, redes más rápidas, shells remotos o configuraciones de red más avanzadas.

Desarrollo

Esta rama sirve para desarrollar sobre el propio sistema.

Para los usuarios que quieren automatizar su servidor o contribuir al ecosistema, la sección de desarrollo abarca entornos de scripting, flujos de contribución y desarrollo impulsado por la comunidad.

Aunque no estés desarrollando una aplicación completa, un pequeño script puede resultar sorprendentemente útil cuando te evita repetir la misma tarea administrativa cada semana.

Desarrollo de App Store

Ejecutar aplicaciones y desarrollarlas son dos etapas distintas del mismo recorrido.

El desarrollo de App Store está pensado para quienes quieren empaquetar aplicaciones Docker, publicarlas para los usuarios de ZimaOS, crear catálogos de aplicaciones, trabajar con metadatos de Docker Compose, gestionar recursos y localización, o automatizar flujos de trabajo de publicación de aplicaciones.

Si la sección de App Store es el patio de recreo, esta es la zona de trabajo que hay detrás.

API de ZimaOS

Cuando hacer clic manualmente en los botones ya no es suficiente, la API se convierte en la siguiente capa.

La sección de API de ZimaOS ofrece una vía para el control mediante programación, la autenticación, las integraciones, los endpoints disponibles y las herramientas para explorar cómo otras aplicaciones pueden comunicarse con ZimaOS.

Eso abre la puerta a scripts personalizados, paneles, herramientas de gestión e integraciones creadas en torno a tu propio entorno de servidor doméstico.

Registro de versiones

El área de desarrollo también mantiene el historial de versiones de ZimaOS junto a la documentación técnica.

Esto resulta útil cuando el comportamiento cambia entre versiones, cuando quieres saber cuándo se incorporó una función o cuando una guía depende de una funcionalidad introducida en una versión más reciente de ZimaOS.

5. Centro de ayuda: empieza por el síntoma

A veces no quieres aprender un protocolo de almacenamiento nuevo. Solo quieres que la máquina vuelva a arrancar.

El Centro de ayuda de ZimaSpace es deliberadamente el camino más corto del mapa. En lugar de exigir que primero entiendas la causa raíz, te permite comenzar con el problema que realmente puedes ver.

Descripción general

Si has llegado aquí, es muy probable que algo ya no esté funcionando como esperabas.

El Centro de ayuda orienta a los usuarios hacia material de solución de problemas y referencia, en lugar de obligarlos a buscar en cada guía de configuración para decidir si el problema pertenece al software, al almacenamiento, a la red o al hardware.

Solución de problemas

Si el dispositivo no arranca, falla la creación del RAID, desaparece la conexión de red, necesitas probar la memoria, debes revisar la BIOS o una conexión de hardware no funciona, empieza aquí.

La ruta de solución de problemas está diseñada para acortar la distancia entre:

«Algo no funciona» → «Esto parece ser mi problema» → «Esto es lo que debes comprobar».

Por lo general, eso es más útil que esperar que alguien sepa si un problema pertenece al sistema operativo, la capa de almacenamiento, la pila de red o el hardware antes de empezar a buscar ayuda.

Referencia

No todas las páginas útiles tienen que ser una guía paso a paso.

El área de Referencia contiene información de apoyo y material técnico que los usuarios pueden necesitar consultar ocasionalmente sin seguir un tutorial completo.

Comunidad: cuando la documentación es solo el principio

La documentación funciona mejor cuando el problema ya tiene una respuesta clara. Los servidores domésticos no siempre colaboran.

Puede que tu configuración combine una tarjeta de red, un controlador de almacenamiento, una pila de Docker y una versión del sistema operativo para los que no se haya escrito ninguna guía específica. Tal vez quieras saber cómo resolvió otro usuario el mismo problema de almacenamiento de Immich. O quizá hayas creado algo lo bastante útil como para que otras personas deban conocerlo.

Ahí es donde la Comunidad de ZimaSpace se convierte en la siguiente capa del mapa de aprendizaje.

La comunidad reúne varios tipos de conocimiento que son difíciles de recoger en una documentación estática:

• Solución de problemas reales: descubre cómo otros usuarios diagnostican problemas inusuales de ZimaOS, aplicaciones, almacenamiento, redes y hardware.
• Tutoriales de la comunidad: descubre flujos de trabajo y configuraciones creados por personas que ejecutan ZimaOS en sus propios entornos.
• Experimentos de hardware: compara tarjetas de expansión, configuraciones de red, configuraciones de almacenamiento, proyectos de virtualización y otras construcciones de laboratorios domésticos.
• Comentarios e ideas: sugiere funciones, informa de problemas y debate cómo podrían mejorar ZimaOS y el hardware de Zima.
• Anuncios: sigue los lanzamientos de ZimaOS, las actualizaciones de productos, los proyectos de la comunidad y otros cambios en todo el ecosistema.

Una regla útil es sencilla: usa la documentación cuando necesites seguir el camino establecido; usa la comunidad cuando quieras ver cómo lo recorren realmente otras personas.

Si no encuentras la respuesta de inmediato, vuelve a la página de inicio de la documentación de ZimaSpace o continúa la conversación en la Comunidad de ZimaSpace.

Preguntas frecuentes: cómo orientarse en la nueva documentación de ZimaSpace

¿Por dónde debería empezar un nuevo usuario de ZimaOS?

Comienza con la guía Primeros pasos con ZimaOS. Desde ahí, el recorrido natural suele continuar por Configuración y almacenamiento, Sincronización y copias de seguridad, y Acceso y uso compartido antes de que empieces a añadir más aplicaciones.

¿Necesito leer las cinco secciones de documentación en orden?

No. La documentación funciona mejor como un mapa que como un libro. Un usuario nuevo puede comenzar con ZimaOS, mientras que un usuario experimentado de un homelab que busque ZFS o SSH puede ir directamente a la documentación para desarrolladores. Si algo ya está averiado, comienza por el Centro de ayuda.

¿Dónde puedo encontrar las guías de almacenamiento y RAID de ZimaOS?

Para planificar el almacenamiento habitual, comienza con la guía de configuración del almacenamiento de ZimaOS. Para temas más avanzados, como ZFS, RAID avanzado, NFS o iSCSI, continúa en Desarrollador → Almacenamiento y sistema de archivos.

¿Dónde debería buscar Jellyfin, Plex, Immich u otras aplicaciones autoalojadas?

Comienza con la documentación de App Store. Servidor multimedia incluye servicios como Jellyfin, Plex, Emby, Immich, DLNA y flujos de trabajo multimedia relacionados, mientras que Aplicaciones autoalojadas abarca una gama más amplia de servicios.

¿Dónde están las guías de IA local?

Abre la documentación de App Store y sigue la sección IA y aprendizaje automático. Esta reúne modelos locales, búsqueda con IA, inteligencia para fotos, flujos de trabajo de IA sin conexión y proyectos con agentes.

¿Por dónde debería empezar con ZimaBoard 2?

Comienza con la guía de inicio de ZimaBoard 2. Desde ahí, puedes pasar al almacenamiento, las redes, la expansión, la refrigeración, ZimaOS o sistemas de terceros, según lo que quieras construir.

¿Puedo instalar ZimaOS en mi propio hardware x86?

Sí. La guía Cómo instalar ZimaOS explica el proceso de instalación para hardware x86-64 compatible, por lo que resulta útil tanto para proyectos de NAS y servidores domésticos DIY como para el hardware Zima.

¿Puedo instalar otro sistema operativo en el hardware Zima?

Sí. La documentación de hardware incluye una sección de sistemas de terceros para usuarios que experimentan con sistemas operativos alternativos de NAS, Linux o redes.

¿Dónde encuentro la documentación sobre API, SSH, ZFS o redes avanzadas?

Ve directamente a la documentación para desarrolladores. Es la rama avanzada para almacenamiento, redes, desarrollo, desarrollo de aplicaciones de la tienda de aplicaciones y la API de ZimaOS.

¿Cuándo debería usar la comunidad de ZimaSpace en lugar de la documentación?

Usa la documentación cuando necesites un proceso establecido de configuración, puesta a punto o solución de problemas. Usa la comunidad de ZimaSpace cuando tu configuración sea inusual, quieras comparar experiencias reales, necesites ayuda de otros usuarios, quieras compartir tu propia solución o tengas comentarios que puedan ayudar a mejorar el ecosistema.

¿Qué debo hacer si no sé qué sección contiene mi problema?

Si algo ha dejado de funcionar, empieza por el Centro de ayuda y busca el síntoma que coincida con tu problema. Si estás intentando construir o configurar algo nuevo, vuelve a la página de inicio de la documentación de ZimaSpace y elige el recorrido más cercano a tu objetivo. Si tu situación queda fuera del recorrido documentado, plantea la pregunta en la comunidad de ZimaSpace.

Un servidor doméstico realmente no tiene un nivel final. Siempre hay otra unidad que añadir, otra aplicación que probar, otra copia de seguridad que mejorar u otro extraño proyecto de fin de semana esperando hacerse realidad.

La nueva documentación está diseñada para ese tipo de recorrido. Comienza donde estés, sigue la rama que corresponda a lo que estás construyendo y profundiza tanto como necesite tu proyecto. Y cuando termine el camino documentado, probablemente haya alguien en la comunidad que ya haya intentado llegar un poco más lejos.

Explora la nueva documentación de ZimaSpace →

¿Tienes alguna pregunta, una solución alternativa o un proyecto que valga la pena compartir? Únete a la comunidad de ZimaSpace →