Unable to pull n8n image in docker

I am getting an error when I try to pull n8n image in docker. Please advice what steps can I follow so that I can use n8n for free.

Hi @Aashna_Ramtri

Please follow these steps

Step 1: Clean up your Docker cache (Most likely fix) Corrupted partial downloads often get stuck in your local cache. You need to clear them out. Open your terminal and run:

# This removes all unused containers, networks, and dangling images
docker system prune

# To be more thorough and remove all unused images (not just dangling ones):
docker image prune -a

Step 2: Restart the Docker service Sometimes the Docker daemon itself gets into a bad state.

  • Windows/Mac: Restart “Docker Desktop” from the menu bar.
  • Linux: Run sudo systemctl restart docker

Step 3: Pull a specific version instead of latest The :latest tag can sometimes point to a manifest that is being updated or cached incorrectly by a local proxy. Try pulling a specific, stable version instead:

docker pull n8nio/n8n:2.30.7

Step 4: Check your network/VPN If you are using a VPN, a corporate proxy, or a highly restrictive firewall, these can intercept and “mangle” the data packets during large downloads. Try disconnecting from your VPN or switching to a different network to see if the pull succeeds.

Hi @Aashna_Ramtri
“Unable to pull” on n8n almost always comes down to the image name or Docker Hub’s anonymous pull limit: pulling plain n8n or n8n/n8n returns “repository does not exist / pull access denied”, and unauthenticated Docker Hub pulls can hit a rate cap. n8n ships its image on its own registry, which avoids both. Pull it fully qualified:

docker pull docker.n8n.io/n8nio/n8n