Cómo instalar Layerling en Docker - CAD sencillo para impresión 3D autohospedado

Layerling | CAD | Impresión 3D | Docker | Self-hosted | AGPL-3.0

Layerling en Docker: CAD sencillo para impresión 3D en tu NAS o tu servidor

Layerling es un editor de CAD que funciona en el navegador, sin cuenta y sin subir tus diseños a ningún sitio. Pon una forma sobre la mesa, ajústala, resta un agujero, redondea un borde e imprímelo. La imagen oficial se puede ejecutar en Docker en tu NAS o en tu servidor casero.

Vídeo tutorial en YouTube

Mira el vídeo completo sobre cómo instalar y usar Layerling en Docker en el canal GENBYTE:

3D </> GENBYTE Homelab • Docker • Self-Hosting Docker Opensource Self-Host Suscríbete al canal GENBYTE

Clickea la miniatura para ir a YouTube →

¿Qué es Layerling?

Layerling es un editor de CAD para impresión 3D que funciona en el navegador. Está pensado para quien tiene una impresora 3D y necesita una pieza que encaje, no para quien quiere estudiar CAD. Coloca formas sobre la mesa, arrástralas hasta su tamaño, convierte una segunda forma en agujero, agrupa y exporta a STL.

Según su propio README, no hay que registrarse ni tener cuenta: los diseños viven en el navegador de cada persona. Es un fork de SketchForge-3D, de Formsmith746, con licencia AGPL-3.0.

Para homelabs: si tienes un NAS o un servidor, puedes ejecutar tu propia copia en Docker y que toda la gente de casa (o del taller) la abra desde el navegador.

Características principales

Sin cuenta

Abre la página y empieza a diseñar. Los diseños se guardan en el navegador.

Formas primitivas

Cajas, cilindros, esferas, conos, pirámides, cuñas, texto, tubos, toros y más.

Sólidos y agujeros

Convierte formas en herramientas de corte y agrúpalas para obtener la geometría final.

Chaflanes y redondeos

Aplica un chaflán o un redondeo a cualquier borde de un sólido, y quítalo después si cambias de idea.

Geometría exacta

Mantiene formas CAD exactas, no solo una malla, así que un borde redondeado sigue siendo redondeado.

Exportación

STL y OBJ para el laminador, y STEP si el diseño tiene que pasar después a un CAD completo.

Proyectos .lyl

Guarda el proyecto completo, con historial, bocetos y grupos, y ábrelo en otro sitio.

Modo servidor

Con una carpeta compartida, los proyectos se guardan en el servidor y toda la red puede abrirlos.

Requisitos del sistema

  • Docker y Docker Compose (en sistemas antiguos, el comando puede ser docker-compose)
  • Arquitectura: el README indica que cada release se publica para amd64 y arm64, así que sirve también para Raspberry Pi o NAS ARM
  • Puerto 3000 del contenedor, que se puede mapear a cualquier puerto del host
  • Opcional: una carpeta en el host para la zona de proyectos compartidos

Instalación con Docker Compose

Paso 1: docker-compose.yml

# Basado en el compose de docker/ del repositorio oficial services: layerling: image: henmedia/layerling:latest container_name: layerling ports: - "3000:3000" environment: PORT: "3000" HOSTNAME: "0.0.0.0" # Desactiva la telemetría de Next.js (1 = desactivada) NEXT_TELEMETRY_DISABLED: "1" # Color por defecto para quien entra por primera vez: system, light, dark o graphite # LAYERLING_DEFAULT_THEME: "graphite" # Carpeta compartida de proyectos (ver sección de configuración avanzada) # LAYERLING_SHARED_PROJECTS_DIR: "/shared-projects" volumes: # Vistas previas de la pantalla de inicio: sobreviven a las actualizaciones - layerling-thumbnails:/app/.codex/project-thumbnails # - ./shared-projects:/shared-projects restart: unless-stopped volumes: layerling-thumbnails:
Nota sobre volúmenes: el volumen layerling-thumbnails es el que recomienda el propio README para las vistas previas, así que aquí se usa un volumen Docker en lugar de una carpeta. El resto de la configuración no usa volúmenes.

Paso 2: Iniciar Layerling

docker compose up -d # Comprueba que el contenedor arranca docker compose logs -f layerling

Paso 3: Comprobar la versión

# Muestra la versión de la imagen que está corriendo docker inspect layerling | grep image.version

Acceder a Layerling

Desde el propio servidor: http://localhost:3000
Desde otro dispositivo de tu red: http://IP_DEL_SERVIDOR:3000

Primeros pasos

  1. Abre la dirección en el navegador. No hace falta cuenta.
  2. Pulsa en un nuevo diseño y arrastra una forma sobre la mesa.
  3. Convierte una segunda forma en agujero, agrúpalas y ajusta las medidas desde el panel.
  4. Exporta a STL para tu laminador desde el menú de exportación.

Casos de uso

  • Piezas a medida: soportes, tapas o separadores que tienen que encajar en algo concreto.
  • Taller compartido: una sola instancia en el NAS para toda la casa o el makerspace.
  • Importar lo que ya tienes: cargar un STL y construir alrededor.
  • Asistente de IA: con el servidor MCP activado, un cliente de IA puede trabajar en el editor mientras tú miras cada paso (ver configuración avanzada).

Configuración avanzada

Carpeta compartida de proyectos

# En docker-compose.yml, descomenta y ajusta: environment: LAYERLING_SHARED_PROJECTS_DIR: "/shared-projects" volumes: - ./shared-projects:/shared-projects # El contenedor corre como el usuario 999. Ese usuario debe poder escribir en la carpeta: sudo chown 999:999 ./shared-projects
Importante: sin los permisos correctos, la carpeta aparece en la pantalla de inicio pero no se puede guardar nada en ella. Si prefieres que el contenedor corra como tu propio usuario, añade user: "1000:1000" con tus números (id -u e id -g).

Acceso desde un proxy inverso

Si accedes con un dominio detrás de un proxy, añade la dirección a LAYERLING_ALLOWED_ORIGINS, separadas por comas. Sin eso, el servidor rechaza guardar en la carpeta compartida.

LAYERLING_ALLOWED_ORIGINS: "https://layerling.tudominio.com"

Servidor MCP para asistentes de IA (opcional)

Una copia alojada en tu red puede dejar que un cliente de IA controle los editores abiertos. Está desactivado por defecto, porque quien pueda controlarlo también puede leer y cambiar los diseños abiertos. Para activarlo hacen falta dos variables, y el token debe tener al menos 16 caracteres:

LAYERLING_MCP_REMOTE: "true" LAYERLING_MCP_TOKEN: "un-secreto-largo-y-aleatorio" # Solo si accedes con un dominio real, por ejemplo detrás de un proxy: LAYERLING_MCP_ALLOWED_HOSTS: "layerling.tudominio.com"
Seguridad: guarda el token en un fichero .env y nunca en el compose ni en un blog. Usa el servidor MCP solo en una red de confianza, y si sales a Internet, usa HTTPS, porque el token viaja en una cabecera.

Comprobar la configuración en ejecución

docker exec layerling printenv LAYERLING_SHARED_PROJECTS_DIR

Gestión y mantenimiento

Ver logs

docker compose logs -f layerling

Actualizar a la última versión

docker compose pull docker compose up -d
Importante: tras cambiar variables de entorno, usa docker compose up -d. El docker compose restart conserva la configuración anterior.

Detener Layerling

docker compose down

Stack técnico

  • Aplicación: web con Next.js sobre Node.js (la imagen usa Node 24 según el Dockerfile)
  • Geometría: motor CAD basado en OCCT (occt-wasm), que mantiene formas exactas
  • Almacenamiento: diseños en el navegador; proyectos compartidos en una carpeta del servidor
  • Imagen Docker: imagen oficial para amd64 y arm64, puerto 3000
  • Licencia: GNU AGPL-3.0 only

Referencias oficiales

Apoya el canal GENBYTE

Suscríbete al canal de YouTube Suscríbete a la newsletter semanal Invítame a un Ko-fi genbyte@proton.me

Sígueme en mis redes sociales

Telegram Discord GitHub Blog Twitter (@gen_byte)

Comentarios

Publicar un comentario

Entradas populares de este blog

Cómo Instalar y configurar SERVIDOR VPN WIREGUARD en MIKROTIK 🔐 #VPN #Wireguard #Mikrotik #RouterOS

Imagen
Wireguard en Mikrotik Breve Explicación de Wireguard ¿Qué es WireGuard VPN? WireGuard es un nuevo protocolo de VPN. No se trata de un software, sino de un conjunto de instrucciones que permite crear VPNs de forma muy sencilla. Ha sido desarrollada como una alternativa a IPsec, OpenVPN y similares VPNs, pero más rápida y sencilla de usar. En esencia, WireGuard está basado en ideas del protocolo IPsec. WireGuard es una VPN extremadamente simple, pero rápida y moderna que utiliza criptografía de última generación. Su objetivo es ser más rápido, más simple, y más versátil que IPSec, evitando al mismo tiempo el enorme dolor de cabeza (sobre todo en redes con NAT). Pretende ser considerablemente más eficaz que OpenVPN. WireGuard está diseñado como una VPN de propósito general para ejecutarse en interfaces embebidas, apto para muchas circunstancias diferentes. Se ejecuta sobre el protocolo UDP, por lo tanto es considerado un túnel de capa 3. ¿Cómo funciona Wireguard VPN? WireGuard es un proto...
Read more »

Cómo instalar y configurar DSM SYNOLOGY 7.2.2 en PC | Guía completa, instalación, RAID 1, SMB

Imagen
Instalación y puesta en marcha de Synology DSM 7.2.2 en PC Vídeo ACTUALIZADO, NUEVA VERSIÓN DEL ARC LOADER:  https://youtu.be/LgghogL-UCA https://genbyte.blogspot.com/2025/08/como-convertir-pc-en-synlogy-con-6-tb.html ----- Proceso de instalación y puesta en marcha de sistema operativo DSM Synology versión 7.2.2 en un PC, concretamente un HP 800 G1 EliteDesk. El PC tendrá 3 discos SSD, uno de 120 GB para el S.O. DSM, y otros dos de 240GB cada en RAID 1 para los Datos. Los 3 dicos duros conectados al PC mediante cables SATA. Lo primero que necesitamos es descargar la imagen bootloader ARC, desde el siguiente repositorio de Gothub, también necesitamos Rufus, en este momento, es la versión 4.6. Imagen ARC:  https://github.com/AuxXxilium/arc Imagen usado en el vídeo 1.1.29:  https://github.com/AuxXxilium/arc/releases/tag/1.1.29 Rufus:  https://rufus.ie/es/ Después de descargar la imagen ARC.img, conectamos nuestro primer disco SSD de 120GB por cable o conector SATA-USB y...
Read more »

Cómo INSTALAR y CONFIGURAR OpenVPN en MIKROTIK. Guía completa paso a paso.

Imagen
Cómo INSTALAR y CONFIGURAR OpenVPN en MIKROTIK. Guía completa paso a paso. Vídeo tutorial paso a paso en Youtube Desarrollo Ilustración: Diagrama RED Creación de Redes (Address) ----------------------------------------------- WAN 192.168.1.0/24 LAN 192.168.88.0/24 VPN 192.168.100.0/24 Creación del Rango VPN ------------------------ 192.168.100.1 - 192.168.100.100 Creación de los Certificados ------------------------------- Los certificados que vamos a crear a continuación tendrán una validez de 10 años; days-valid=3650 Crear certificado CA ---------------------- /certificate add name=CA-tpl country="" state="" locality="" organization="" unit="" common-name="CA" key-size=4096 days-valid=3650 key-usage=crl-sign,key-cert-sign /certificate sign CA-tpl ca-crl-host=127.0.0.1 name="CA" Crear certificado Server -------------------------- /certificate add name=SERVER-tpl country="" state="" locality=...
Read more »