Corregir "Error: kernel does not support overlay fs" en Steam Deck - Solución Definitiva

Corregir "Error: kernel does not support overlay fs" en Steam Deck

Solución Paso a Paso para SteamOS

Entendiendo el Error

Si estás intentando usar herramientas de contenedores como Podman o Docker en tu Steam Deck con SteamOS, podrías encontrarte con este molesto error:

            Error: kernel does not support overlay fs: 'overlay' is not supported over extfs at "/home/deck/.local/share/containers/storage/overlay": backing file system is unsupported for this graph driver
        

Esto ocurre porque SteamOS tiene una estructura de sistema de archivos única diseñada para gaming. El sistema raíz usa Btrfs con particiones de solo lectura, mientras que tu directorio home está en una partición ext4. El controlador overlay no funciona de forma nativa en esta configuración ext4.

En esta guía, te mostraré la solución permanente para corregir este error y hacer que tus contenedores funcionen correctamente en el Steam Deck.

Diagrama de Solución

El proceso de solución sigue estos pasos:

Intentar habilitar 'overlay' en el kernel.
Si funciona, hacerlo permanente.
Si no funciona, cambiar el controlador de almacenamiento a 'fuse-overlayfs'.
Verificar que la solución funcione.

Solución Paso a Paso

A Habilitar Soporte Overlay en el Kernel

1 Habilitar Soporte Overlay Temporalmente

Abre la Terminal en tu Steam Deck (en Modo Escritorio) y ejecuta:

                        sudo modprobe overlay
                    

2 Probar Operación de Contenedor

Intenta ejecutar tu comando de contenedor nuevamente:

                        podman run hello-world
                    

Nota: Si esto funciona, ve al paso A.3. Si no, procede a la Sección B.

3 Hacer el Cambio Permanente

Para que el cambio persista después de reinicios:

                        echo "overlay" | sudo tee /etc/modules-load.d/overlay.conf
sudo systemctl restart systemd-modules-load
                    

B Cambiar Configuración de Almacenamiento

Si habilitar overlay no funcionó, prueba una de estas opciones:

1 Opción B.1: Usar Almacenamiento Temporal

                        mkdir -p ~/.config/containers
cat <<EOF > ~/.config/containers/storage.conf
[storage]
driver = "overlay"
graphroot = "/tmp/containers/storage"
runroot = "/tmp/containers/run"
EOF
                    

Mejor para: Contenedores temporales.

2 Opción B.2: Usar FUSE OverlayFS (Recomendado)

1. Instalar fuse-overlayfs:

                        # Descargar, dar permisos y mover
curl -LO https://github.com/containers/fuse-overlayfs/releases/download/v1.13/fuse-overlayfs-x86_64
chmod +x fuse-overlayfs-x86_64
mkdir -p ~/.local/bin
mv fuse-overlayfs-x86_64 ~/.local/bin/fuse-overlayfs
                    

2. Configurar almacenamiento:

                        mkdir -p ~/.config/containers
cat <<EOF > ~/.config/containers/storage.conf
[storage]
driver = "overlay"
mount_program = "$HOME/.local/bin/fuse-overlayfs"
EOF
                    

Mejor para: La mayoría de usuarios que necesitan almacenamiento persistente.

C Verificar la Solución

1 Comprobar Soporte en Kernel

                        lsmod | grep overlay
                    

2 Probar Operación de Contenedor

                        podman run --rm hello-world
                    

Deberías ver un mensaje de éxito.

Notas Finales

¡Felicidades! Has resuelto el error. La Opción B.2 (fuse-overlayfs) es la más recomendada.

Estos cambios sobrevivirán a las actualizaciones de SteamOS porque se guardan en tu directorio home.

Si aún tienes problemas, resetea tu almacenamiento con:

            podman system reset
        

Advertencia: ¡Esto borrará todos tus contenedores e imágenes!

Solución a Contenedores en Steam Deck | Publicado en Junio 2025

Esta solución funciona en SteamOS 3.0+ y es compatible con Podman.

Opinador compulsivo

Buscar este blog