Starting container testcontaiers throw an error

[MrResor]

Expected Behaviour
Container starts properly and the tests are performed

Actual Behaviour
Error is thrown and tests are skipped:

TypeError: Cannot read properties of undefined (reading 'length')
 ❯ node_modules/testcontainers/src/generic-container/inspect-container-util-ports-exposed.ts:27:72
 ❯ common_1.IntervalRetry.retryUntil.message node_modules/testcontainers/src/generic-container/inspect-container-util-ports-exposed.ts:27:10
 ❯ IntervalRetry.retryUntil node_modules/testcontainers/src/common/retry.ts:47:20
 ❯ inspectContainerUntilPortsExposed node_modules/testcontainers/src/generic-container/inspect-container-util-ports-exposed.ts:18:18
 ❯ GenericContainer.startContainer node_modules/testcontainers/src/generic-container/generic-container.ts:205:52

Part of the code that throws said error:

const container = await buildtContainer.withEnvironment({
    POSTGRES_PASSWORD: process.env.POSTGRES_PASSWORD,
    PGUSER: process.env.USER_LOGIN,
    PGPASSWORD: process.env.USER_PASSWORD,
    PGPORT: Number(process.env.DB_PORT),
  })
  .withExposedPorts(Number(process.env.DB_PORT))
  .withNetworkMode('host')
  .withWaitStrategy(Wait.forLogMessage('[1] LOG:  database system is ready to accept connections'))
  .start()

Testcontainer Logs
No logs as container has not yet started

Steps to Reproduce
I was running the test using testcontainers and github actionsand i got an uneralated (error about npm having issues with optional dependencies). I followed the instruction to remove node_modules and package-lock.json and reinstalled the dependencies. After that each time i try to run the test both localy and on github action i get the error above. In addition i tried to install the dependencies with -legacy-peer-deps, but result remain unchanged. My understanding of both node.js and testcontainers is quite shallow but my guess is that one of the dependencies is not properly installed and causes issues with the testcontaiers code. All the code run properly unitill latest github actions down period on 5.06

Environment Information

• Operating System: Ubuntu 24.04.2 LTS
• Docker Version: 28.2.0, build 879ac3f
• Node version: 22.16.0
• Testcontainers version: 11.0.1

[MrResor]

Just tested and test do run properly with Testcontainers version 11.0.0

[cristianrgreco]

Thanks for raising @MrResor, will deploy a fix for this shortly.

[MrResor]

That was fast, thanks
I will check later if it works and will let you know because i feel like i am doing some weird stuff for my particular case :)

[cristianrgreco]

Released in 11.0.2, lemme know!

[MrResor]

Just ran the test, not sure if this in particular is not my fault (again, doing some funky stuff), but this time i got Error you implemented:

Error: Container did not expose all ports after starting
 ❯ node_modules/testcontainers/src/generic-container/inspect-container-util-ports-exposed.ts:31:14
 ❯ IntervalRetry.retryUntil node_modules/testcontainers/src/common/retry.ts:49:16
 ❯ inspectContainerUntilPortsExposed node_modules/testcontainers/src/generic-container/inspect-container-util-ports-exposed.ts:18:18
 ❯ GenericContainer.startContainer node_modules/testcontainers/src/generic-container/generic-container.ts:205:52

Exact same case as before, all versions are the same except for test containers (now version 11.0.2)

[cristianrgreco]

That's odd, it means there are no host port bindings for your container even though we've defined them. Would you be able to share the result of a docker inspect of your container when you get the error?

[MrResor]

Will try to

[MrResor]

Took some fast fingers which was not easy with buggy connection but i got this:

The files belonging to this database system will be owned by user "postgres".
This user must also own the server process.

The database cluster will be initialized with locale "en_US.utf8".
The default database encoding has accordingly been set to "UTF8".
The default text search configuration will be set to "english".

Data page checksums are disabled.

fixing permissions on existing directory /var/lib/postgresql/data ... ok
creating subdirectories ... ok
selecting dynamic shared memory implementation ... posix
selecting default "max_connections" ... 100
selecting default "shared_buffers" ... 128MB
selecting default time zone ... Etc/UTC
creating configuration files ... ok
running bootstrap script ... ok
performing post-bootstrap initialization ... ok
syncing data to disk ... ok

initdb: warning: enabling "trust" authentication for local connections
initdb: hint: You can change this by editing pg_hba.conf or using the option -A, or --auth-local and --auth-host, the next time you run initdb.

Success. You can now start the database server using:

    pg_ctl -D /var/lib/postgresql/data -l logfile start

waiting for server to start....2025-06-07 20:51:22.886 UTC [47] LOG:  starting PostgreSQL 17.4 (Debian 17.4-1.pgdg120+2) on aarch64-unknown-linux-gnu, compiled by gcc (Debian 12.2.0-14) 12.2.0, 64-bit
2025-06-07 20:51:22.888 UTC [47] LOG:  listening on Unix socket "/var/run/postgresql/.s.PGSQL.5433"
2025-06-07 20:51:22.897 UTC [50] LOG:  database system was shut down at 2025-06-07 20:51:22 UTC
2025-06-07 20:51:22.903 UTC [47] LOG:  database system is ready to accept connections
 done
server started

/usr/local/bin/docker-entrypoint.sh: sourcing /docker-entrypoint-initdb.d/db-init.sh
CREATE ROLE
CREATE DATABASE
CREATE SEQUENCE
CREATE TABLE
GRANT
GRANT
CREATE TABLE
GRANT
GRANT
GRANT
GRANT
                                 List of roles
    Role name     |                         Attributes                         
------------------+------------------------------------------------------------
 exercise_tracker | 
 postgres         | Superuser, Create role, Create DB, Replication, Bypass RLS


waiting for server to shut down...2025-06-07 20:51:23.502 UTC [47] LOG:  received fast shutdown request
.2025-06-07 20:51:23.506 UTC [47] LOG:  aborting any active transactions
2025-06-07 20:51:23.511 UTC [47] LOG:  background worker "logical replication launcher" (PID 53) exited with exit code 1
2025-06-07 20:51:23.511 UTC [48] LOG:  shutting down
2025-06-07 20:51:23.514 UTC [48] LOG:  checkpoint starting: shutdown immediate
2025-06-07 20:51:23.565 UTC [48] LOG:  checkpoint complete: wrote 944 buffers (5.8%); 0 WAL file(s) added, 0 removed, 0 recycled; write=0.029 s, sync=0.016 s, total=0.054 s; sync files=319, longest=0.003 s, average=0.001 s; distance=4295 kB, estimate=4295 kB; lsn=0/1916DD8, redo lsn=0/1916DD8
2025-06-07 20:51:23.571 UTC [47] LOG:  database system is shut down
 done
server stopped

PostgreSQL init process complete; ready for start up.

2025-06-07 20:51:23.626 UTC [1] LOG:  starting PostgreSQL 17.4 (Debian 17.4-1.pgdg120+2) on aarch64-unknown-linux-gnu, compiled by gcc (Debian 12.2.0-14) 12.2.0, 64-bit
2025-06-07 20:51:23.627 UTC [1] LOG:  listening on IPv4 address "0.0.0.0", port 5433
2025-06-07 20:51:23.629 UTC [1] LOG:  listening on IPv6 address "::", port 5433
2025-06-07 20:51:23.633 UTC [1] LOG:  listening on Unix socket "/var/run/postgresql/.s.PGSQL.5433"
2025-06-07 20:51:23.644 UTC [85] LOG:  database system was shut down at 2025-06-07 20:51:23 UTC
2025-06-07 20:51:23.655 UTC [1] LOG:  database system is ready to accept connections

This would indicate that the container does start, but the port is setup by postrgress, but then it cannot be found ?

[cristianrgreco]

Ah, those are the container logs, could you share the container inspect result?
Should be able to run docker inspect <container-id>

[MrResor]

Okay, i got somewhere, i removed the .withNetworkMode('host') from container start line and instead used await container.getMappedPort(Number(process.env.DB_PORT)), but now my app is unable to connect to the database in the container

[MrResor]

docker inspect result :

[
    {
        "Id": "3ede7362e82b099d1de907740304d561a9fc11071e52b86a25d0af433653f91d",
        "Created": "2025-06-07T21:06:16.431628096Z",
        "Path": "docker-entrypoint.sh",
        "Args": [
            "postgres"
        ],
        "State": {
            "Status": "running",
            "Running": true,
            "Paused": false,
            "Restarting": false,
            "OOMKilled": false,
            "Dead": false,
            "Pid": 3559275,
            "ExitCode": 0,
            "Error": "",
            "StartedAt": "2025-06-07T21:06:16.491411953Z",
            "FinishedAt": "0001-01-01T00:00:00Z"
        },
        "Image": "sha256:4650f1e242412031fcce13f7778fae6888836e20f07d5e6783796f340bdefabe",
        "ResolvConfPath": "/var/lib/docker/containers/3ede7362e82b099d1de907740304d561a9fc11071e52b86a25d0af433653f91d/resolv.conf",
        "HostnamePath": "/var/lib/docker/containers/3ede7362e82b099d1de907740304d561a9fc11071e52b86a25d0af433653f91d/hostname",
        "HostsPath": "/var/lib/docker/containers/3ede7362e82b099d1de907740304d561a9fc11071e52b86a25d0af433653f91d/hosts",
        "LogPath": "/var/lib/docker/containers/3ede7362e82b099d1de907740304d561a9fc11071e52b86a25d0af433653f91d/3ede7362e82b099d1de907740304d561a9fc11071e52b86a25d0af433653f91d-json.log",
        "Name": "/nifty_gagarin",
        "RestartCount": 0,
        "Driver": "overlay2",
        "Platform": "linux",
        "MountLabel": "",
        "ProcessLabel": "",
        "AppArmorProfile": "docker-default",
        "ExecIDs": null,
        "HostConfig": {
            "Binds": null,
            "ContainerIDFile": "",
            "LogConfig": {
                "Type": "json-file",
                "Config": {}
            },
            "NetworkMode": "host",
            "PortBindings": {
                "5433/tcp": [
                    {
                        "HostIp": "",
                        "HostPort": "0"
                    }
                ]
            },
            "RestartPolicy": {
                "Name": "no",
                "MaximumRetryCount": 0
            },
            "AutoRemove": false,
            "VolumeDriver": "",
            "VolumesFrom": null,
            "ConsoleSize": [
                0,
                0
            ],
            "CapAdd": null,
            "CapDrop": null,
            "CgroupnsMode": "private",
            "Dns": null,
            "DnsOptions": null,
            "DnsSearch": null,
            "ExtraHosts": null,
            "GroupAdd": null,
            "IpcMode": "private",
            "Cgroup": "",
            "Links": null,
            "OomScoreAdj": 0,
            "PidMode": "",
            "Privileged": false,
            "PublishAllPorts": false,
            "ReadonlyRootfs": false,
            "SecurityOpt": null,
            "UTSMode": "",
            "UsernsMode": "",
            "ShmSize": 67108864,
            "Runtime": "runc",
            "Isolation": "",
            "CpuShares": 0,
            "Memory": 0,
            "NanoCpus": 0,
            "CgroupParent": "",
            "BlkioWeight": 0,
            "BlkioWeightDevice": null,
            "BlkioDeviceReadBps": null,
            "BlkioDeviceWriteBps": null,
            "BlkioDeviceReadIOps": null,
            "BlkioDeviceWriteIOps": null,
            "CpuPeriod": 0,
            "CpuQuota": 0,
            "CpuRealtimePeriod": 0,
            "CpuRealtimeRuntime": 0,
            "CpusetCpus": "",
            "CpusetMems": "",
            "Devices": null,
            "DeviceCgroupRules": null,
            "DeviceRequests": null,
            "MemoryReservation": 0,
            "MemorySwap": 0,
            "MemorySwappiness": null,
            "OomKillDisable": null,
            "PidsLimit": null,
            "Ulimits": null,
            "CpuCount": 0,
            "CpuPercent": 0,
            "IOMaximumIOps": 0,
            "IOMaximumBandwidth": 0,
            "MaskedPaths": [
                "/proc/asound",
                "/proc/acpi",
                "/proc/interrupts",
                "/proc/kcore",
                "/proc/keys",
                "/proc/latency_stats",
                "/proc/timer_list",
                "/proc/timer_stats",
                "/proc/sched_debug",
                "/proc/scsi",
                "/sys/firmware",
                "/sys/devices/virtual/powercap"
            ],
            "ReadonlyPaths": [
                "/proc/bus",
                "/proc/fs",
                "/proc/irq",
                "/proc/sys",
                "/proc/sysrq-trigger"
            ]
        },
        "GraphDriver": {
            "Data": {
                "ID": "3ede7362e82b099d1de907740304d561a9fc11071e52b86a25d0af433653f91d",
                "LowerDir": "/var/lib/docker/overlay2/b68ef6d55b6fe411a459daf76f92e13ce9d18cf599fe3372a07f9cd263122d65-init/diff:/var/lib/docker/overlay2/17221204f3478101e9c5ae59a1242c80610a1dc261ee591d5a6db44ee020fe95/diff:/var/lib/docker/overlay2/5649d81d6c197b8aa20109ec05e512b19e5fcf28de934aa0652cd2149918ebfd/diff:/var/lib/docker/overlay2/6c5903a7e244aaf1458e690870e61d0391264a148b1b2658f77f57c433d6bcc0/diff:/var/lib/docker/overlay2/affe7be15f545ee986faec475a23b541c967e0e9f510c79ea5aad2408c093528/diff:/var/lib/docker/overlay2/0fe8a8fc2b91902f00b44b8d467474e8532b1d2030f0f3aa7b23d07a85a94174/diff:/var/lib/docker/overlay2/7961e0788afe732cab4ded81fbc470b439678be3cd5e47a0ad8a87669bd245c9/diff:/var/lib/docker/overlay2/98e5fed89b26ccc683c205f63c460b8f2a5f77f9d2c8cb9319eb60af3c7d41fc/diff:/var/lib/docker/overlay2/5f3ef851d024dc5b2d089169e1d7acea9f3c6c29e7ddb85c1675d08df0b79aed/diff:/var/lib/docker/overlay2/d1bff3fa1912dc466377b1f451b7643e77ac2ea32bf8cb8111011e55d0ab81fa/diff:/var/lib/docker/overlay2/1992d7dd8bbc409d025e5a328a3b13d9d4be01dc4ca4ac495ef662606e3226ee/diff:/var/lib/docker/overlay2/3aac7037379eb34cea9237062e8b077d14c4cec56a7cc1bcb353f3ab2d0d2887/diff:/var/lib/docker/overlay2/88b4bfd1834826152a46bd8b7e4559c534a1ea43316d9a1df2102abc20dba526/diff:/var/lib/docker/overlay2/41ef6ff76fb03126f2a9afed1352709f8835fa27728d2601ef85c245e2a6f025/diff:/var/lib/docker/overlay2/661b9fd5c67b95253fdb52eb07a4fbd968ca3b1f512f6241f53f1863156eff1f/diff:/var/lib/docker/overlay2/a63e4f73850e5753489371dd4365ffafb40e7437ef132d6ad08ad16f10fa1a17/diff",
                "MergedDir": "/var/lib/docker/overlay2/b68ef6d55b6fe411a459daf76f92e13ce9d18cf599fe3372a07f9cd263122d65/merged",
                "UpperDir": "/var/lib/docker/overlay2/b68ef6d55b6fe411a459daf76f92e13ce9d18cf599fe3372a07f9cd263122d65/diff",
                "WorkDir": "/var/lib/docker/overlay2/b68ef6d55b6fe411a459daf76f92e13ce9d18cf599fe3372a07f9cd263122d65/work"
            },
            "Name": "overlay2"
        },
        "Mounts": [
            {
                "Type": "volume",
                "Name": "2413440f572ebc095acf0934b1008078415ebc69ca2826a4b4dc2aaa989db841",
                "Source": "/var/lib/docker/volumes/2413440f572ebc095acf0934b1008078415ebc69ca2826a4b4dc2aaa989db841/_data",
                "Destination": "/var/lib/postgresql/data",
                "Driver": "local",
                "Mode": "",
                "RW": true,
                "Propagation": ""
            }
        ],
        "Config": {
            "Hostname": "dev-server",
            "Domainname": "",
            "User": "",
            "AttachStdin": false,
            "AttachStdout": false,
            "AttachStderr": false,
            "ExposedPorts": {
                "5432/tcp": {},
                "5433/tcp": {}
            },
            "Tty": false,
            "OpenStdin": false,
            "StdinOnce": false,
            "Env": [
                "POSTGRES_PASSWORD=SECRET",
                "PGUSER=SECRET",
                "PGPASSWORD=SECRET",
                "PGPORT=5433",
                "PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/lib/postgresql/17/bin",
                "GOSU_VERSION=1.17",
                "LANG=en_US.utf8",
                "PG_MAJOR=17",
                "PG_VERSION=17.4-1.pgdg120+2",
                "PGDATA=/var/lib/postgresql/data"
            ],
            "Cmd": [
                "postgres"
            ],
            "Image": "localhost/51b746722425:e0e9b0b64da3",
            "Volumes": {
                "/var/lib/postgresql/data": {}
            },
            "WorkingDir": "",
            "Entrypoint": [
                "docker-entrypoint.sh"
            ],
            "OnBuild": null,
            "Labels": {
                "org.testcontainers": "true",
                "org.testcontainers.lang": "node",
                "org.testcontainers.session-id": "0dce6b32bd86",
                "org.testcontainers.version": "11.0.2"
            },
            "StopSignal": "SIGINT"
        },
        "NetworkSettings": {
            "Bridge": "",
            "SandboxID": "152fce94a5120b9cd4b22a513b75bc70842cdd54f4bd8663a171a292a9fefbcf",
            "SandboxKey": "/var/run/docker/netns/default",
            "Ports": {},
            "HairpinMode": false,
            "LinkLocalIPv6Address": "",
            "LinkLocalIPv6PrefixLen": 0,
            "SecondaryIPAddresses": null,
            "SecondaryIPv6Addresses": null,
            "EndpointID": "",
            "Gateway": "",
            "GlobalIPv6Address": "",
            "GlobalIPv6PrefixLen": 0,
            "IPAddress": "",
            "IPPrefixLen": 0,
            "IPv6Gateway": "",
            "MacAddress": "",
            "Networks": {
                "host": {
                    "IPAMConfig": null,
                    "Links": null,
                    "Aliases": null,
                    "MacAddress": "",
                    "DriverOpts": null,
                    "GwPriority": 0,
                    "NetworkID": "9ab93b2d28aece3a3c9853ad70ba1f4c7928bc1a7c4513e6aa4bacbbaef26d1c",
                    "EndpointID": "bbd93e2075422c9a724556c6c15951b747a7eea7e7dca14ad039fe7613c213b2",
                    "Gateway": "",
                    "IPAddress": "",
                    "IPPrefixLen": 0,
                    "IPv6Gateway": "",
                    "GlobalIPv6Address": "",
                    "GlobalIPv6PrefixLen": 0,
                    "DNSNames": null
                }
            }
        }
    }
]```

[MrResor]

I think i know what may be the issue, despite setting postrgress port as something else than standard 5432, that port is still there, so i need to expose it as well

[MrResor]

Okay, once again used the get mapped port function, but this time i assigned the variable and it worked.
const port = container.getMappedPort(Number(process.env.DB_PORT))

I tested it for more than one test file and it works only for the first one, the rest fails because app fails to connect to the container

EDIT: I have run the test a few more times, the first file has some random fails for some reason.
I will look into it tomorrow, probably something i am missing

[cristianrgreco]

Do you mind sharing a short repro of the issue? From the inspect result I see both ports are being exposed and yet no ports are bound, which doesn't make sense. From the code you shared previously I don't understand why port 5432 is also exposed.