#21745·minio

Last docker Minio add breaking change in older docker versions

Author: masalinasCreated Feb 10, 2026Updated Feb 12, 2026
Labelscommunitytriage

Current Behavior

I'm using docker to start minio locally and not works in my OS.

Steps to Reproduce (for bugs)

  • Test 01: Execute this command to execute the docker minio version. Not works OK Obtain this error. This test deployed in a new server with ubuntu 24.02 and docker 28.1 works OK
docker run -d \
    --name spark-minio \
    --network spark-net \
    -p 9000:9000 \
    -p 9001:9001 \
    -e MINIO_ROOT_USER=<USER_NAME> \
    -e MINIO_ROOT_PASSWORD=<PASSWORD> \
    -v minio-data:/data \
    minio/minio:latest \
      server /data --console-address ":9000"

Obtain these errors:

API: SYSTEM.bootstrap
Time: 08:44:21 UTC 02/10/2026
Error: Unable to listen on `:9000`: listen tcp :9000: bind: address already in use (*errors.errorString)
       5: internal/logger/logger.go:271:logger.LogIf()
       4: cmd/logging.go:100:cmd.bootLogIf()
       3: cmd/server-main.go:915:cmd.serverMain.func10.1.1()
       2: internal/http/server.go:89:http.(*Server).Init()
       1: cmd/server-main.go:914:cmd.serverMain.func10.1()
INFO: Formatting 1st pool, 1 set(s), 1 drives per set.
INFO: WARNING: Host local has more than 0 drives of set. A host failure will result in data becoming unavailable.
MinIO Object Storage Server
Copyright: 2015-2026 MinIO, Inc.
License: GNU AGPLv3 - https://www.gnu.org/licenses/agpl-3.0.html
Version: RELEASE.2025-09-07T16-13-09Z (go1.24.6 linux/amd64)

API: http://172.20.0.2:9000  http://127.0.0.1:9000 
WebUI: http://172.20.0.2:9001 http://127.0.0.1:9001 

Docs: https://docs.min.io
  • Test 02: Also I execute the command like this with the same error
docker run -d \
    --name spark-minio \
    --network spark-net \
    -p 9000:9000 \
    -p 9001:9001 \
    -e MINIO_ROOT_USER=<USER_NAME> \
    -e MINIO_ROOT_PASSWORD=<PASSWORD> \
    -v minio-data:/data \
    minio/minio:latest \
      server /data --address "0.0.0.0:9000" --console-address "0.0.0.0:9001"
  • Test 03: Also use other ports for address but obtain the same errors
docker run -d \
    --name spark-minio \
    --network spark-net \
    -p 9000:9000 \
    -p 9004:9004 \
    -e MINIO_ROOT_USER=<USER_NAME> \
    -e MINIO_ROOT_PASSWORD=<PASSWORD> \
    -v minio-data:/data \
    minio/minio:latest \
      server /data --address "0.0.0.0:9004" --console-address "0.0.0.0:9001"
  • Test 04: Finally I tested with minio older version like this (RELEASE.2025-01-20T14-49-07Z) and now works ok:
docker run -d \
    --name spark-minio \
    --network spark-net \
    -p 9000:9000 \
    -p 9001:9001 \
    -e MINIO_ROOT_USER=admin \
    -e MINIO_ROOT_PASSWORD=password \
   minio/minio:RELEASE.2025-01-20T14-49-07Z \
      server --console-address ":9001" /data

Something in the last docker minio versions are not compatible with the old version of docker 20.10, related to port 9000. Maybe something change related to IPV6 in new docker versions?

Your Environment

  • Version used (minio --version):  minio/minio:latest
  • Server setup and configuration: errors on docker version 20.10.5. Works ok on docker 28.1
  • Operating System and version (uname -a): errors on Ubuntu 20.02. Works ok on Ubuntu 24.02