Instructions update request

[ssaling]

System Information

• Operating System:
  Linux 6.14.0-28-generic #28~24.04.1-Ubuntu SMP PREEMPT_DYNAMIC Fri Jul 25 10:47:01 UTC 2 x86_64 x86_64 x86_64 GNU/Linux
• Docker Version:
  Docker version 27.5.1, build 27.5.1-0ubuntu3~24.04.2
• Docker Compose Version:
  When running the command docker-compose --version receive the error displayed in Error Details below; however, when running docker compose version the following is received

docker compose version
Docker Compose version v2.35.1

• Available RAM: [How much RAM your system has]
  16GB
• Available Disk Space: [How much free disk space]
  1.5TB

Error Details

• Complete error message(s):

docker-compose --version
Traceback (most recent call last):
  File "/usr/bin/docker-compose", line 33, in <module>
    sys.exit(load_entry_point('docker-compose==1.29.2', 'console_scripts', 'docker-compose')())
             ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/usr/bin/docker-compose", line 25, in importlib_load_entry_point
    return next(matches).load()
           ^^^^^^^^^^^^^^^^^^^^
  File "/usr/lib/python3.12/importlib/metadata/__init__.py", line 205, in load
    module = import_module(match.group('module'))
             ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/usr/lib/python3.12/importlib/__init__.py", line 90, in import_module
    return _bootstrap._gcd_import(name[level:], package, level)
           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "<frozen importlib._bootstrap>", line 1387, in _gcd_import
  File "<frozen importlib._bootstrap>", line 1360, in _find_and_load
  File "<frozen importlib._bootstrap>", line 1331, in _find_and_load_unlocked
  File "<frozen importlib._bootstrap>", line 935, in _load_unlocked
  File "<frozen importlib._bootstrap_external>", line 995, in exec_module
  File "<frozen importlib._bootstrap>", line 488, in _call_with_frames_removed
  File "/usr/lib/python3/dist-packages/compose/cli/main.py", line 9, in <module>
    from distutils.spawn import find_executable
ModuleNotFoundError: No module named 'distutils'

• Step where the error occurred:
  docker-compose up --build both Download And Install Step 4 and the final step in testing initial install of docker.
• What you were trying to do when the error happened:
  This error is triggered when attempting to run docker-compose either in the installing docker step to test, or when attempting to run the framework as indicated in Step 4 of Download And Install

Troubleshooting Steps Taken

• [ X] Verified Docker installation with docker run hello-world
• [ X] Verified Docker Compose with test manifest
• [ X] Checked container logs: docker-compose logs [service-name]
• [ X] Verified system meets minimum requirements
• [ X] Tried running with verbose output: docker-compose up --build --verbose

Container Logs

docker-compose up --build --verbose test-docker-compose.yml
Traceback (most recent call last):
  File "/usr/bin/docker-compose", line 33, in <module>
    sys.exit(load_entry_point('docker-compose==1.29.2', 'console_scripts', 'docker-compose')())
             ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/usr/bin/docker-compose", line 25, in importlib_load_entry_point
    return next(matches).load()
           ^^^^^^^^^^^^^^^^^^^^
  File "/usr/lib/python3.12/importlib/metadata/__init__.py", line 205, in load
    module = import_module(match.group('module'))
             ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/usr/lib/python3.12/importlib/__init__.py", line 90, in import_module
    return _bootstrap._gcd_import(name[level:], package, level)
           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "<frozen importlib._bootstrap>", line 1387, in _gcd_import
  File "<frozen importlib._bootstrap>", line 1360, in _find_and_load
  File "<frozen importlib._bootstrap>", line 1331, in _find_and_load_unlocked
  File "<frozen importlib._bootstrap>", line 935, in _load_unlocked
  File "<frozen importlib._bootstrap_external>", line 995, in exec_module
  File "<frozen importlib._bootstrap>", line 488, in _call_with_frames_removed
  File "/usr/lib/python3/dist-packages/compose/cli/main.py", line 9, in <module>
    from distutils.spawn import find_executable
ModuleNotFoundError: No module named 'distutils'

Additional Context

• Are you running this in a corporate/enterprise environment?
  No
• Do you have any security software that might interfere with Docker?
  No
• Have you successfully run other Docker containers on this system?
  Yes

NOTE This is an issue with newer versions of docker compose where docker-compose is no longer a viable command; however, docker compose (notice no '-' between docker and compose) does work. This should either be an entry in the troubleshooting Q/A section, or the steps instructing to use docker-compose updated to reflect docker compose.