Unquoted port mappings

Reports unquoted port mappings in Docker Compose files.

According to the Compose file specification, mapping ports in the HOST:CONTAINER format may lead to erroneous results when using a container port lower than 60, because YAML parses numbers in the format xx:yy as a base-60 value. For this reason, we recommend always explicitly specifying the port mappings as strings.

Examples:

  ports:
    - 3000
    - 3000-3005
    - 22:22
    - 8080:8080

After the quick-fix is applied:

  ports:
    - "3000"
    - "3000-3005"
    - "22:22"
    - "8080:8080"

Locating this inspection

By ID

Can be used to locate inspection in e.g. Qodana configuration files, where you can quickly enable or disable it, or adjust its settings.

ComposeUnquotedPorts

Via Settings dialog

Path to the inspection settings via IntelliJ Platform IDE Settings dialog, when you need to adjust inspection settings directly from your IDE.

Settings or Preferences | Editor | Inspections | Docker-compose

Inspection ID: ComposeUnquotedPorts

Suppressing Inspection

You can suppress this inspection by placing the following comment marker before the code fragment where you no longer want messages from this inspection to appear:

//noinspection ComposeUnquotedPorts

More detailed instructions as well as other ways and options that you have can be found in the product documentation:

Inspection Details
By default bundled with:	CLion 2025.2, GoLand 2025.2, IntelliJ IDEA 2025.2, JetBrains Rider 2025.2, PhpStorm 2025.2, PyCharm 2025.2, Qodana for .NET 2025.2, Qodana for Go 2025.2, Qodana for JS 2025.2, Qodana for JVM 2025.2, Qodana for PHP 2025.2, Qodana for Ruby 2025.2, RubyMine 2025.2, WebStorm 2025.2

Last modified: 18 September 2025