[Troubleshooting] docker: request returned Internal Server Error for API route and version http://%2F%2F.%2Fpipe%2Fdocker_engine/v1.24/containers/create?name=mysql, check if the server supports the requested API version.

1. 오류원인

이 오류는 Docker가 지원하지 않는 API버전을 요청하거나, Docker 서버와의 통신 문제로 발생할 수 있습니다.

2. 오류내용

Window 11 cmd에서 도커 명령어를 입력했을 때, 아래와 같은 오류를 맞닥뜨렸습니다.

docker: request returned Internal Server Error for API route and version
http://%2F%2F.%2Fpipe%2Fdocker_engine/v1.24/containers/create?name=mysql,
check if the server supports the requested API version.

 

3. 해결책

0. Docker를 재부팅합니다.

재부팅은 언제나 가장 쉽고, 간편하게 시도해볼 수 있는 해결책입니다.

1. 다른 권한으로 실행

Docker 명령어를 실행하는 사용자의 권한이 적절하지 않을 수 있기 때문에 적절한 권한을 지닌 채로 명령어를 실행해볼 수 있습니다.

sudo 혹은 실행 권한이 있는 그룹 사용자를 통해 명령어를 실행합니다.

2. Beta 기능 사용

Docker Desktop 애플리케이션의 Beta기능을 사용할 수 있습니다.

이를 통해 더 높은 버전을 미리 시도해볼 수 있으며, 기존에 호환되지 않았던 문제가 해결될 가능성이 있습니다.

그 중, containered 기능이 있습니다.

containered는 컨테이너 이미지 관리와 실행을 위한 오픈 소스 컨테이너 런타임입니다.

Use containered for pulling and storing images를 활성화하면,

containered를 통해 Docker를 동작하여 다중 플랫폼을 지원하는 등 범용적인 기능을 제공받아 오류가 해결될 가능성이 있습니다.

4. 참조

https://github.com/docker/desktop-linux/issues/156

Docker Desktop Fails to Start Daemon · Issue #156 · docker/desktop-linux