Docker fails to start after system update: overlay module missing

Hello everyone,

After running yay -Syyu to update my system, I found that Docker is no longer able to start. I’ve tried troubleshooting but haven’t been able to resolve the issue. I hope someone can help.


Problem Description

When I attempt to start Docker using:

sudo systemctl start docker

I get the following error:

Job for docker.service failed because the control process exited with error code.
See "systemctl status docker.service" and "journalctl -xeu docker.service" for details.

Checking the output of systemctl status docker.service, I see:

× docker.service - Docker Application Container Engine
     Loaded: loaded (/usr/lib/systemd/system/docker.service; disabled; preset: disabled)
     Active: failed (Result: exit-code) since ...
   Main PID: ... (code=exited, status=1/FAILURE)

... Failed to start Docker Application Container Engine.

Running sudo dockerd directly provides the following error:

INFO[2024-12-05T22:49:25.760533581+08:00] Starting up                                  
ERRO[2024-12-05T22:49:25.799777808+08:00] failed to mount overlay: no such device       storage-driver=overlay2
ERRO[2024-12-05T22:49:25.799829647+08:00] [graphdriver] prior storage driver overlay2 failed: driver not supported 
failed to start daemon: error initializing graphdriver: driver not supported

Attempting to load the overlay module:

sudo modprobe overlay

results in:

modprobe: FATAL: Module overlay not found in directory /lib/modules/6.6.54-2-MANJARO

What I’ve Tried

  1. Ensured the kernel headers are installed:
sudo pacman -Syu linux-headers

It shows the headers are already installed.
2. Checked for the overlay module:

lsmod | grep overlay

No output, indicating the module is not loaded.
3. Verified my current kernel version:

uname -r

Output: 6.6.54-2-MANJARO.
4. Temporarily changed the Docker storage driver to vfs (which has lower performance): Edited /etc/docker/daemon.json to include:

{
  "storage-driver": "vfs"
}

Restarting the Docker service did not resolve the issue.


System Information

  • System Version: Manjaro (Kernel 6.6.54-2-MANJARO)
  • Docker Version: Latest version installed from the official repository
  • Update Command: yay -Syyu

What I Need Help With

  1. Why is the overlay module missing after the update? Do I need to reinstall a specific kernel or related modules?
  2. Has anyone experienced a similar issue on Manjaro? Are there known solutions?
  3. Would switching to an LTS kernel (like 6.1) be a recommended solution? If so, how can I minimize potential compatibility issues during the switch?

I’d appreciate any suggestions or guidance. Thank you!

Just as with pacman, only one (1) Y is recommended when performing an update with yay;

Using yay:

yay -Syu

Using pacman:

sudo pacman -Syu

I’m unable to offer advice concerning docker.

Regards.

1 Like

After a system update, you have to reboot.

3 Likes

This worked for me and docker is now running successfully. Thank you very much!

1 Like

This topic was automatically closed 3 days after the last reply. New replies are no longer allowed.