ErrLookup › docker/compose
docker/compose
Define and run multi-container applications with Docker · Go · 199 source files
Analyzed at ddc4b044b6 on 2026-08-15. 256 documented errors.
| Code / Message | Type | Severity | Tags |
|---|---|---|---|
| cannot specify DEPRECATED "--no-ansi" and "--ansi". Please u | validation | error | cli, flags, deprecated, ansi |
| cannot specify DEPRECATED "--workdir" and "--project-directo | validation | error | cli, flags, deprecated, project-directory |
| source can not be empty | validation | error | cli, cp, validation, arguments |
| destination can not be empty | validation | error | cli, cp, validation, arguments |
| invalid filter '${filter}' | validation | error | cli, ls, filter, validation |
| --index requires one service to be selected | validation | error | cli, logs, flags, validation |
| arguments to --filter should be in form KEY=VAL | validation | error | cli, ps, filter, validation |
| cannot publish compose file with local includes | validation | error | publish, oci, includes, compose-file |
| cannot combine --attach and --attach-dependencies | validation | error | cli, up, flags, validation, attach |
| not found | error_code | error | api, sentinel-error, not-found |
| already exists | error_code | error | api, sentinel-error, conflict |
| forbidden | error_code | error | api, sentinel-error, authorization |
| unknown | error_code | error | api, sentinel-error, unknown |
| not implemented | error_code | error | api, sentinel-error, not-implemented, ps |
| unsupported flag | error_code | error | api, sentinel-error, flags, backend |
| canceled | error_code | warning | api, sentinel-error, canceled, interactive |
| parsing failed | error_code | error | api, sentinel-error, parsing |
| no resources | error_code | warning | api, sentinel-error, no-resources, rm, kill |
| use_api_socket can't be used with a Windows Docker Engine | validation | error | windows, api-socket, engine, compose-file |
| healthcheck.start_interval requires healthcheck.start_period | validation | error | healthcheck, compose-file, validation, convert |
| copying between services is not supported | validation | error | copy, cli, validation, compose-cp |
| unknown copy direction | validation | error | copy, cli, validation, compose-cp |
| Docker Compose does not support configs.*.driver | validation | error | configs, compose-file, swarm, container-create |
| Docker Compose does not support configs.*.template_driver | validation | error | configs, compose-file, swarm, container-create |
| Docker Compose does not support secrets.*.driver | validation | error | secrets, compose-file, swarm, container-create |
| Docker Compose does not support secrets.*.template_driver | validation | error | secrets, compose-file, swarm, container-create |
| project name can't be empty. Use ProjectName option to set a | validation | error | project-name, loader, validation |
| 'compose' is not a valid provider type | validation | error | provider, plugins, compose-file, validation |
| your Compose stack cannot be published as it only contains a | validation | error | publish, registry, compose-file, validation |
| service %q didn't complete successfully: exit %d | exception | error | depends-on, convergence, startup, healthcheck |
| no available sync implementation | exception | error | watch, sync, environment, experimental |
| watch rules MUST define a path | validation | error | watch, develop, compose-file, validation |
| process still running | exception | error | watch, sync-exec, exec, container |
| interactive run is not supported in dry-run mode | validation | error | dry-run, interactive, run, tty |
| interactive exec is not supported in dry-run mode | exception | error | dry-run, exec, interactive |
| invalid ssh key %q | validation | error | build, ssh, cli, flag-parsing |
| failed to parse env_file %s: %w | exception | error | env-file, parsing, configuration |
| error parsing command line, expected %q | validation | error | cli, cobra, plugin, internal |
| %s must be an integer (found: %q) | validation | error | environment, cli, configuration, validation |
| can't use --progress tty while ANSI support is disabled | validation | error | progress, ansi, tty, cli |
| can't use --progress plain while ANSI support is forced | validation | error | cli, progress, ansi, flags, conflict |
| unsupported --progress value %q | validation | error | cli, progress, flags, validation |
| unsupported format %q | validation | error | cli, config, format, flags, validation |
| --build and --no-build are incompatible | validation | error | cli, create, build, flags, conflict |
| --force-recreate and --no-recreate are incompatible | validation | error | cli, create, recreate, flags, conflict |
| invalid --pull option %q | validation | error | cli, create, pull-policy, flags, validation |
| invalid --scale option %q. Should be SERVICE=NUM | validation | error | cli, scale, flags, validation, parsing |
| invalid value for --rmi: %q | validation | error | cli, down, rmi, flags, validation |
| at least one container must be specified | validation | error | cli, generate, experimental, arguments |
| unsupported format %q | validation | error | cli, generate, format, flags, validation |
| service %q build.platforms does not support value set by DOC | validation | error | platform, build, environment, arm64, validation |
| service %q build configuration does not support platform: %s | validation | error | platform, build, compose-file, validation |
| operation cancelled by user | exception | error | interactive, interpolation, environment, prompt, user-abort |
| unknown filter %s | validation | error | cli, ps, filter, not-implemented |
| no such service: %s | validation | error | cli, ps, service-name, validation |
| --service-ports and --publish are incompatible | validation | error | cli, run, ports, flags, conflict |
| --tty and --no-tty can't be used together | validation | error | cli, run, tty, flags, conflict |
| label must be set as KEY=VALUE | validation | error | cli, run, labels, flags, parsing |
| invalid scale specifier: %s | validation | error | cli, scale, argument-parsing, compose |
| invalid scale specifier: can't parse replica value as int: % | validation | error | cli, scale, argument-parsing, strconv, compose |
| cannot combine %s and --remove-orphans | validation | error | cli, up, flags, environment, orphans, compose |
| no service selected | validation | error | cli, up, profiles, project-loading, compose |
| --wait-timeout must be a non-negative integer | validation | error | cli, up, flags, validation, timeout, compose |
| --abort-on-container-failure cannot be combined with --abort | validation | error | cli, up, flags, validation, abort, compose |
| --wait cannot be combined with --abort-on-container-exit, -- | validation | error | cli, up, flags, validation, wait, attach, compose |
| --build and --no-build are incompatible | validation | error | cli, up, flags, validation, build, compose |
| --wait cannot be combined with --abort-on-container-exit, -- | validation | error | cli, up, flags, validation, wait, watch, detach, compose |
| --detach cannot be combined with --abort-on-container-exit, | validation | error | cli, up, flags, validation, detach, attach, watch, compose |
| --no-recreate and --renew-anon-volumes are incompatible | validation | error | cli, up, flags, validation, volumes, compose |
| --force-recreate and --no-recreate are incompatible | validation | error | cli, up, flags, validation, recreate, compose |
| --always-recreate-deps and --no-recreate are incompatible | validation | error | cli, up, flags, validation, recreate, dependencies, compose |
| --no-build and --watch are incompatible | validation | error | cli, up, flags, validation, watch, build, compose |
| cannot attach to services not included in up: %s | validation | error | cli, up, attach, services, validation, compose |
| invalid indentation size: %d | validation | error | cli, viz, flags, validation, compose |
| no such service: %s | validation | error | cli, volumes, services, validation, compose |
| cannot take exclusive lock for project %q: %w | exception | error | cli, watch, locking, filesystem, permissions, compose |
| format value %q could not be parsed: %w | validation | error | cli, formatter, format, json, output, compose |
| could not open Docker Desktop | console | warning | docker-desktop, keyboard-menu, gui, url-scheme, tui |
| could not open Docker Desktop Compose UI | console | warning | docker-desktop, keyboard-menu, gui, url-scheme, tui |
| could not open Docker Desktop Logs view: %w | console | warning | docker-desktop, keyboard-menu, logs, url-scheme, tui |
| watch is not yet configured. Learn more: %s | console | info | watch, keyboard-menu, developer-experience, compose-file |
| unexpected status code: %d | http | warning | docker-desktop, http, api-client, status-code |
| unsupported protocol for address: %s | validation | error | network, unix-socket, named-pipe, validation, go |
| unsupported network: %s | validation | error | network, unix-socket, named-pipe, validation, go |
| named pipes are only available on Windows | validation | error | named-pipe, windows, platform, network, go |
| socket address is too long: %s | validation | error | unix-socket, path-length, validation, platform, go |
| unsupported OCI version: %s | validation | error | oci, artifact, registry, push, go |
| creating fetcher for %s: %w | exception | error | oci, registry, auth, resolver, network |
| fetching blob %s: %w | exception | error | oci, registry, blob, http, pull |
| reading blob %s: %w | exception | error | oci, registry, blob, io, network |
| blob %s size mismatch: expected %d bytes, got %d | exception | error | oci, registry, blob, integrity, validation |
| invalid digest %s: %w | validation | error | oci, digest, validation, integrity, go |
| blob digest mismatch: expected %s, got %s | exception | critical | oci, integrity, security, registry, digest |
| invalid PID (%d): only positive PIDs are allowed | validation | error | pidfile, process, validation, go |
| process with PID %d is still running | exception | error | pidfile, single-instance, process, locking, go |
| stat %q: %w | exception | error | filesystem, sync, permissions, tar, go |
| deleting paths in %s: %w | exception | error | containers, exec, sync, tar, go |
| copying files to %s: %w | exception | error | containers, tar, sync, disk-full, go |
| inspecting %q: %w | exception | error | filesystem, permissions, sync, tar, go |
| archiving %q: %w | exception | error | tar, sync, filesystem, go |
| writing %q header: %w | exception | error | tar, sync, io-pipe, go |
| copying %q: %w | exception | error | filesystem, tar, sync, io, go |
| finalizing %q: %w | exception | error | tar, sync, io, go |
| walking %q: %w | exception | error | filesystem, permissions, walk, sync, go |
| making %q relative to %q: %w | exception | error | windows, filesystem, sync, paths, go |
| adding files to tar: %w | exception | error | tar, sync, goroutine, io-pipe, go |
| closing tar: %w | exception | error | tar, sync, io-pipe, go |
| loading otel config from docker context metadata: %w | exception | error | docker-context, otel, tracing, configuration, go |
| restoring env for %q: %w | panic | critical | otel, environment, panic, tracing, go |
| stashing env for %q: %w | exception | error | otel, environment, tracing, go |
| initializing otel connection from docker context metadata: % | exception | error | otel, grpc, docker-context, tracing, configuration, go |
| unexpected type for field %q: %T (expected: %T) | exception | error | otel, docker-context, type-mismatch, configuration, json, go |
| failed to create resource: %w | exception | warning | otel, tracing, resource, go |
| invalid service %q. Must specify either image or build | validation | error | compose-api, validation, service-config, build |
| service %q build.platforms does not support value set by DOC | validation | error | platform, environment, build, validation |
| service %q build configuration does not support platform: %s | validation | error | platform, validation, build, service-config |
| cannot render project into yaml: %w | exception | error | bridge, yaml, serialization, convert |
| cannot create output folder: %w | exception | error | filesystem, permissions, bridge, convert |
| output folder %s already exists | validation | error | filesystem, transformer, bridge, validation |
| cannot create output folder: %w | exception | error | filesystem, permissions, transformer, bridge |
| resolving credentials failed: %w | exception | error | credentials, docker-config, api-socket, authentication |
| saving creds for API socket: %w | exception | error | credentials, serialization, api-socket, authentication |
| invalid service %q. Must specify either image or build | validation | error | compose, validation, service-config, build |
| can't access os.tempDir %s: %w | exception | error | filesystem, temp-dir, bake, environment |
| failed to execute bake: %w | exception | error | bake, buildx, process, io |
| build result not found in Bake metadata for service %s | exception | error | bake, metadata, buildx, version-skew |
| failed to get version of buildx | exception | error | buildx, plugin, version, installation |
| compose build requires buildx %s or later | validation | error | buildx, version, compatibility, build |
| the classic builder doesn't support multi-arch build, set DO | validation | error | classic-builder, buildkit, platform, build |
| the classic builder doesn't support privileged mode, set DOC | validation | error | classic-builder, buildkit, privileged, build |
| the classic builder doesn't support additional contexts, set | validation | error | classic-builder, buildkit, build-context, build |
| the classic builder doesn't support SSH keys, set DOCKER_BUI | validation | error | build, buildkit, ssh, classic-builder |
| the classic builder doesn't support secrets, set DOCKER_BUIL | validation | error | build, buildkit, secrets, classic-builder |
| building from STDIN is not supported | validation | error | build, stdin, context, classic-builder |
| unable to prepare context: %w | exception | error | build, context, filesystem, path |
| unable to open Dockerfile: %w | exception | error | build, dockerfile, filesystem, permissions |
| unable to prepare context: path %q not found | validation | error | build, context, path, configuration |
| checking context: %w | exception | error | build, context, permissions, dockerignore |
| no container found for project %q: %w | exception | error | project, not-found, containers, runtime-state |
| no such service: %q: %w | validation | error | service, not-found, validation, runtime-state |
| docker client returned empty version after successful API ne | exception | error | docker-client, api-version, embedding, negotiation |
| service %q is not running container #%d | exception | error | containers, exec, scale, index, not-found |
| service %q is not running | exception | error | containers, exec, not-running, service |
| WARNING: The %q service is using the custom container name % | validation | error | scale, container-name, configuration, replicas |
| cannot share volume with service %s: container missing | exception | error | volumes-from, dependencies, convergence, containers |
| cannot share network namespace with service %s: container mi | exception | error | network-mode, namespaces, dependencies, convergence |
| cannot share IPC namespace with service %s: container missin | exception | error | ipc, namespaces, dependencies, convergence |
| cannot share PID namespace with service %s: container missin | exception | error | pid, namespaces, dependencies, convergence |
| %s is missing dependency %s | exception | error | depends-on, dependencies, startup-order, convergence |
| dependency failed to start: %w | exception | error | |
| timeout waiting for dependencies | exception | error | |
| container %s exited (%d) | exception | error | |
| container %s has no healthcheck configured | exception | error | |
| container %s is unhealthy | exception | error | |
| container %s had unexpected health status %q | exception | error | |
| service %q has no container to start | exception | error | |
| no container found for service %q | exception | error | |
| destination "%s:%s" must be a directory or a regular file: % | validation | error | |
| destination "%s:%s" must be a directory | validation | error | |
| external volume %q not found | exception | error | |
| invalid DNS address: %w | validation | error | |
| the service-level mac_address should have the same value as | validation | error | |
| invalid IPv4 address: %w | validation | error | |
| invalid IPv6 address: %w | validation | error | |
| invalid link-local IP: %w | validation | error | |
| invalid security-opt: %q | validation | error | |
| opening seccomp profile (%s) failed: %w | exception | error | |
| compacting json for seccomp profile (%s) failed: %w | exception | error | |
| interface_name requires Docker Engine %s or later | validation | error | |
| volume with type=image require Docker Engine %s or later | validation | error | volumes, mounts, versioning, docker-engine |
| unsupported external config %s | validation | error | configs, compose-file, swarm-migration |
| unsupported external secret %s | validation | error | secrets, compose-file, swarm-migration |
| failed to create network %s: %w | exception | error | network, docker-api, subnet, retryable |
| network %s declared as external, but could not be found | exception | error | network, external-resources, compose-file |
| multiple networks with name %q were found. Use network ID as | exception | error | network, ambiguity, external-resources |
| invalid subnet: %w | validation | error | network, ipam, validation, cidr |
| invalid ip-range: %w | validation | error | network, ipam, validation, cidr |
| invalid gateway address: %w | validation | error | network, ipam, validation, gateway |
| invalid auxiliary address: %w | validation | error | network, ipam, validation |
| invalid MAC address: %w | validation | error | network, mac-address, validation |
| service %s is required by %s but is disabled. Can be enabled | validation | error | dependencies, profiles, compose-file |
| could not find %s: %w | exception | error | dependencies, compose-file, not-found |
| cycle found: %s | exception | error | dependencies, cycle-detection, compose-file |
| failed to list networks: %w | exception | error | network, docker-api, teardown, retryable |
| failed to remove network %s: %w | exception | error | network, teardown, docker-api |
| output option is required when exporting to terminal | validation | error | export, cli, stdout, validation |
| failed to export container: %w | exception | error | export, filesystem, validation |
| no container(s) found with the following name(s): %s | validation | error | generate, containers, not-found |
| %s hook exited with status %d | exception | error | hooks, lifecycle, exec, exit-code |
| unsupported image prune mode: %s | validation | error | images, prune, validation, api-misuse |
| unable to get image '%s': %w | exception | error | images, inspect, daemon, registry |
| no label %q set on container %q of compose project | validation | warning | ls, labels, containers, state |
| 'models' support requires Docker Model plugin | exception | error | models, plugin, ai, environment |
| failed to load Docker Model plugin: %w | exception | error | models, plugin, installation |
| error checking docker-model status: %w | exception | error | models, plugin, exec, status |
| error checking available models: %w | exception | error | models, plugin, exec, catalog |
| error unmarshalling available models: %w | exception | error | models, json, plugin, schema |
| invalid response from plugin: %s | exception | error | plugins, service-provider, protocol, env |
| failed to %s service provider: %s | exception | error | plugins, service-provider, process, crash |
| required parameter %q is missing from provider %q definition | validation | error | plugins, provider, validation, compose-file |
| no port %s for container %s: %s | validation | warning | port, networking, cli, ports |
| service %q pre_start[%d]: per_replica is not yet supported; | validation | error | pre-start, hooks, replicas, validation |
| service %q pre_start[%d] wait error: %s | exception | error | pre-start, hooks, wait, oom |
| service %q pre_start[%d] exited with code %d | exception | error | pre-start, hooks, exit-code, init |
| failed to access env file %s: %w | exception | error | compose, publish, env-file, filesystem, permissions |
| failed to load compose file %s: %w | exception | error | compose, publish, extends, yaml, file-loading |
| failed to scan compose file %s: %w | exception | error | compose, publish, secret-scanning, yaml |
| env file %s not found | validation | error | compose, publish, env-file, missing-file |
| failed to scan env file %s: %w | exception | error | compose, publish, env-file, secret-scanning, io |
| failed to scan config file %s: %w | exception | error | compose, publish, configs, secret-scanning, io |
| failed to scan secret file %s: %w | exception | error | compose, publish, secrets, secret-scanning, io |
| failed to resolve digest for %s: %w | exception | error | compose, registry, digest, auth, network |
| %q attribute is mandatory to push an image for service %q | validation | error | compose, push, service-image, validation |
| cannot create %s %q in read-only service %s: `file` is the s | validation | error | compose, secrets, configs, read-only, containers |
| environment variable %q required by %s %q is not set | validation | error | compose, secrets, environment, configuration |
| application not healthy after %s | exception | error | compose, wait, healthcheck, timeout, dependencies |
| no containers for project %q | exception | error | compose, wait, containers, lifecycle |
| none of the selected services is configured for watch, see h | validation | warning | compose, watch, develop, configuration |
| can't watch service %q with action %s without a build contex | validation | error | compose, watch, rebuild, build-context |
| --no-build is incompatible with watch action %s in service % | validation | error | compose, watch, no-build, flag-conflict |
| none of the selected services is configured for watch, consi | validation | warning | compose, watch, develop, configuration |
| resolving symlink for %q: %w | exception | error | compose, watch, x-develop, symlinks, filesystem |
| service %s doesn't have a build section, can't apply %s on w | validation | error | compose, watch, config, develop |
| can't watch with action %q on service %s without a command | validation | error | compose, watch, config, exec |
| exit code %d | exception | error | compose, watch, exec, exit-code |
| could not get created time for service's image | exception | error | compose, watch, container-not-found, docker-api |
| could not find the file %s in container %s | exception | warning | compose, dry-run, cp, file-not-found |
| COMPOSE_EXPERIMENTAL_GIT_REMOTE environment variable expects | validation | error | compose, environment, git-remote, config |
| git remote resource is disabled by %q | validation | error | compose, git-remote, include, feature-flag |
| initializing remote resource cache: %w | exception | error | compose, git-remote, cache, filesystem |
| git subdirectory must be relative, got: %s | validation | error | compose, git-remote, path-validation |
| git subdirectory path traversal detected: %s | validation | error | compose, git-remote, path-traversal, security |
| invalid git subdirectory path: %w | validation | error | compose, git-remote, windows, path-validation |
| git subdirectory escapes base directory: %s | validation | error | compose, git-remote, path-traversal, security |
| repository does not contain ref %s, output: %q: %w | exception | error | compose, git-remote, ref-not-found, include |
| failed to access repository at %s: %s | exception | error | compose, git-remote, network, authentication |
| unexpected git command output: %q | exception | error | compose, git-remote, git-protocol |
| invalid commit sha %q | validation | error | compose, git-remote, git-protocol, validation |
| invalid OCI artifact | validation | error | compose, oci, include, path-validation |
| COMPOSE_EXPERIMENTAL_OCI_REMOTE environment variable expects | validation | error | compose, environment, oci, config |
| OCI remote resource is disabled by %q | validation | error | go, docker-compose, oci, feature-flag, configuration |
| failed to pull OCI resource %q: %w | exception | error | go, docker-compose, oci, registry, network, authentication |
| initializing remote resource cache: %w | exception | error | go, docker-compose, oci, filesystem, cache, permissions |
| OCI index %s doesn't refer to compose artifacts | validation | error | go, docker-compose, oci, validation, user-error |
| %s is not a compose project OCI artifact, but %s | validation | error | go, docker-compose, oci, validation, user-error |
| missing annotation com.docker.compose.envfile in layer %q | validation | error | go, docker-compose, oci, bundle-format, validation |
| error reading .dockerignore: %w | exception | error | go, docker-compose, dockerignore, watch, configuration |
| cannot watch root directory | validation | error | go, docker-compose, watch, filesystem, path-validation |
| os.Stat(%q): %w | exception | error | go, docker-compose, watch, filesystem, permissions |
| newWatcher: %w | exception | error | go, docker-compose, watch, macos, filesystem, cwd |
| notify.Add(%q): %w | exception | error | go, docker-compose, watch, filesystem, permissions, inotify |
| watcher.Add(%q): %w | exception | error | go, docker-compose, watch, inotify, linux, resource-limits |
| hit OS limits creating a watcher. Run 'sysctl fs.inotify.max | exception | error | go, docker-compose, watch, inotify, linux, resource-limits, os-limits |
| creating file watcher: %w | exception | error | go, docker-compose, watch, fsnotify, file-descriptors, os-limits |
| newWatcher: %w | exception | error | go, docker-compose, watch, filesystem, cwd, linux |
| finding ancestor of %s: %w | exception | error | docker-compose, file-watching, fsnotify, filesystem, configuration |