Copia de seguridad y restauración de la configuración de WLED (cfg.json, presets.json y paletas)
Qué archivos de WLED guardar (cfg.json, presets.json, paletas), cómo restaurarlos en un ESP32 nuevo y por qué los horarios viven en cfg.json.
La mayoría de la gente descubre dónde guarda WLED su configuración justo después de perderla. Todo vive en unos pocos archivos JSON en la memoria flash de la propia luz: cfg.json para los ajustes (Wi-Fi, salidas LED, sincronización, temporizadores) y presets.json para los preajustes y las listas de reproducción. Las paletas personalizadas, los ledmaps y los mapas de controles remotos son archivos aparte. Guarda copias antes de cada actualización de firmware y antes de cambiar un controlador. El método de la interfaz web de abajo es gratis y solo necesita un navegador.
Qué archivos importan
| Archivo | Qué contiene | ¿Hacer copia? |
|---|---|---|
| cfg.json | Wi-Fi, salidas LED, GPIO, límite de corriente, sincronización, hora y temporizadores, ajustes de módulos de usuario | sí |
| presets.json | todos los preajustes y las listas de reproducción | sí |
| palette0.json, palette1.json… | paletas personalizadas (WLED 0.14 y posteriores; hasta 10 en 0.14, 0.15 y en ESP8266, muchas más en WLED 16 con ESP32) | si creaste alguna |
| ledmap.json, ledmap1.json… | mapas de píxeles personalizados para matrices y distribuciones raras | si los usas |
| ir.json, remote.json | asignación de botones del mando IR y del mando ESP-NOW | si los usas |
Los temporizadores y horarios están en cfg.json, no en presets.json. La gente restaura sus preajustes, busca su temporizador del atardecer y ya no está. Por eso.
Copia de seguridad desde un navegador
- Abre la luz en un navegador y ve a Config›Security & Updates.
- Toca Backup presets. El navegador descarga presets.json.
- Toca Backup configuration. El navegador descarga cfg.json.
- Cámbiales el nombre a los dos con el nombre de la luz y la fecha, como
porch-cfg-2026-05-10.json. Si no, terminas con diez archivos que se llaman cfg.json.

Las paletas y los ledmaps no están en esa página. Abre http://<light-ip>/edit, el editor de archivos de WLED, y descarga cada archivo desde ahí.
Restaurar
En la misma página: Restore presets y Restore configuration. Elige el archivo y toca Upload. La luz se reinicia después de restaurar la configuración. Las contraseñas no van en la copia de seguridad, así que cuenta con escribir de nuevo la contraseña del Wi-Fi cuando pongas una configuración en una placa nueva.
Restaurar una configuración en una placa distinta necesita un poco de cuidado.
Los ajustes de Wi-Fi y de red vienen incluidos. Si la luz anterior tenía una IP estática y sigue funcionando, ahora tienes dos luces con la misma dirección.
Lo mismo pasa con el GPIO y el tipo de LED. Si la placa nueva usa otro pin de datos (una placa QuinLED frente a una D1 mini, por ejemplo), la tira se queda apagada hasta que corrijas las salidas en LED & Hardware (llamado LED Preferences en 0.15 y anteriores).
Restaurar una configuración trae los ajustes de red y el pin de datos de la placa anterior. En una placa distinta, revisa la IP y las salidas LED justo después.
Pasar de ESP8266 a ESP32, o al revés, se puede, pero revisa cada salida después. Los chips tienen números de pin y límites distintos.
Los preajustes se mueven con mucha más seguridad que las configuraciones, porque un preajuste guarda diseños, no ajustes de hardware. El único detalle son los ID de efecto: WLED 16 cambió el significado de algunos (el efecto 77, por ejemplo), así que los preajustes creados en 0.15 pueden verse distintos en 16.
Copia de seguridad y restauración en WLED Max
En WLED Max está en Ajustes > Copia de seguridad y restauración, en iOS y Android.
En Crear copia de seguridad, elige una luz junto a Dispositivo (si solo tienes una luz, ya viene elegida) y toca Hacer copia ahora.

Estas copias de seguridad se guardan cifradas dentro de la app en tu móvil, y no hay un botón para exportar una como archivo, así que se quedan en ese móvil. En Android, Exportar datos de la app (también en Copia de seguridad y restauración) guarda tu lista de luces, grupos y preajustes globales en un archivo, pero no estas copias de las luces. Si quieres una copia fuera del móvil, descarga también los archivos sin procesar desde la interfaz web.
Para restaurar, toca una copia en Copias de seguridad guardadas. Restaurar en [luz original] pone todo de vuelta donde estaba. Restaurar en otro dispositivo… lo pone en otra luz, por ejemplo un ESP32 nuevo que reemplaza a uno que dejó de funcionar.
Lo útil es lo que no toca. Una restauración conserva los ajustes de red y de identidad propios de la luz de destino. Restaurar la copia del porche en una placa nueva no copia el Wi-Fi, la IP estática ni el nombre de la luz del porche, así que no terminas con dos luces peleando por una misma dirección. Los diseños, los preajustes, las paletas y los horarios sí pasan. Los ajustes del cableado de los LED pasan solo cuando es seguro (mira abajo).
Desde la versión 1.1.4, en iOS y Android, la app revisa la luz que elegiste y te explica en palabras simples qué va a pasar. Las copias de seguridad hechas con 1.1.4 o posterior recuerdan de qué luz vienen.
- La misma luz. Aparece un simple Restaurar, y todo vuelve.
- Otra luz con el mismo chip. Eliges entre Restaurar todo (útil cuando un ESP32 nuevo reemplaza a uno que dejó de funcionar y está cableado igual) y Restaurar sin cambiar la configuración LED (conserva la configuración LED de esta luz).
- Un chip distinto, por ejemplo una copia de un ESP32 que va a un ESP8266, o a un ESP32-S3 o C3. Solo se ofrece Restaurar sin cambiar la configuración LED. La luz conserva sus propias salidas LED, pines de datos, tipo y número de LED, botones, pines de IR y relé, distribución de la matriz, ledmaps y ajustes de módulos de usuario. Todo lo demás viene de la copia.
- Pines que la luz no tiene. Igual que con un chip distinto: la luz conserva su propia configuración LED, y la app nombra los pines, por ejemplo GPIO 25.
- Copias más antiguas (hechas antes de 1.1.4) no dicen de dónde vienen, así que la app sugiere conservar la configuración LED de la luz. Restaurar todo sigue ahí si sabes que el cableado coincide.
También te avisa sobre el firmware. Una copia de un WLED más nuevo que va a uno más antiguo se salta los ajustes que la versión anterior no conoce, y los horarios pueden no funcionar igual. Al pasar de 0.15 a 16 cambiaron algunos efectos, así que algunos preajustes pueden verse un poco distintos. Una copia de WLED MoonModules que va a WLED estándar, o al revés, también lleva una nota.
Restaurar en [luz original] encuentra la luz correcta aunque tu router le haya dado una dirección nueva. Si ahora otra luz responde en la dirección anterior, la app se detiene, te lo dice (“Esta es otra luz”) y no cambia nada.
La misma pantalla también tiene Copiar preajustes entre dispositivos en Migración. Los pasos y las advertencias están en la guía de preajustes.
Si el presets.json de una luz se daña (un corte de luz a mitad de un guardado lo provoca), la pestaña Preajustes lo detecta y ofrece Guardar una copia del archivo antes de que pase cualquier otra cosa. Guarda esa copia. Muchas veces se puede sacar a mano la mayoría de los preajustes de ahí.
Cuándo hacer una copia de seguridad
Cuando terminas de configurar una luz. Antes de cada actualización de firmware. Antes de cambios grandes de preajustes o segmentos, sobre todo la renovación anual para las fiestas.
Y guarda también una copia de la interfaz web en un ordenador. Una copia que solo existe en tu móvil desaparece si restableces la app o pierdes el móvil.
Problemas al restaurar
La restauración terminó, pero la tira está apagada. La configuración vino de una placa con otro pin de datos u otro tipo de LED. Revisa las salidas en LED & Hardware (LED Preferences en 0.15). WLED Max 1.1.4 conserva por su cuenta la configuración LED de la luz de destino cuando los chips son distintos, así que esto pasa sobre todo con la restauración desde la interfaz web o con Restaurar todo.
Los preajustes se restauraron, pero los efectos se ven mal. O es una diferencia de firmware (mira la nota sobre los ID de efecto de arriba), o el efecto no existe en la compilación de destino, como los efectos de audio en una compilación sin AudioReactive.
Faltan los horarios después de restaurar. Solo restauraste presets.json. Los temporizadores están en cfg.json.
Faltan las paletas personalizadas. Son archivos aparte. Vuelve a ponerlas con /edit, o usa la copia de seguridad de WLED Max, que las incluye.
¿Lo siguiente es una actualización de firmware? Lee primero Actualización OTA de WLED en ESP8266 y ESP02. Si lo que en realidad cambias es tu móvil y no tus luces, consulta pasar tu configuración de la app WLED a un móvil nuevo.