【Rancher Desktop】 Docker起動時のコンフリクトエラー「Error response from daemon: Conflict. The container name XX is already in use by container.」

目次

• バージョン
• エラーの内容
• エラーの原因
  • Rancher Desktopを確認
• 解決方法
  • 方法1. コンテナを削除
  • 方法2. 名前を変更（リネーム）

バージョン

MacBook Air（Apple M3）：Sonoma 14.7.2
Rancher Desktop：1.20.0
Kubernetes：1.32.5

エラーの内容

hoge@user project-backend % docker-compose up -d

[+] Running 2/2
 ✘ Container dynamodb_local       Error resp...                            0.0s 
 ✔ Container ces-mypage-prot-api  Remov...                                 0.0s 
 
Error response from daemon: Conflict.
The container name "/dynamodb_local" is already in use by container "hogehogehoge".

You have to remove (or rename) that container to be able to reuse that name.

エラーの原因

Docker コンテナ名の衝突が起きています。

ポイントはエラー文の「The container name "/dynamodb_local" is already in use」です。

Rancher Desktopを確認

Containersを確認します。

すでに他のプロジェクトにて「dynamodb_local」という名前のコンテナが存在していることが分かりました。
そこで新たに同じ名前で作成しようとして衝突している状態です。

既存のコンテナが「起動中」「停止中」に関わらず、同じ名前のコンテナが存在していることがNGです。

解決方法

方法1. コンテナを削除

コンフリクトのエラーを調べると、古いコンテナを削除する方法が出てきました。
ただ既存のコンテナも、今回起動したいコンテナも同じ頻度で使うため、毎回削除するのは面倒だなと思いました。

そのため、後述する「名前を変更する方法」をとることにしました。

方法2. 名前を変更（リネーム）

ここで、プロジェクトのdocker-compose.ymlファイルを確認します。

services:
  dynamodb-local:
    container_name: dynamodb_local
  dynamodb-admin:
    container_name: dynamodb-admin

今回は「dynamodb_local」だけでなく「dynamodb-admin」も名前の重複があり、エラーが起きていたので、両方変更したいと思います。

以下のように2つの名前を変更しました。

そのあと再度 docker-compose up -d を実行し、無事に起動できました。