docker compose fails to start due to a critical I/O error

[daudix]

The compose file is docker-compose.for-traefik.yml, with some minor adjustments to fit my setup. Volume contains some files, so it's unlikely to be a permission error.

Container logs (edit: using -logging- image):

2025-11-03T22:46:04.393373Z DEBUG main:start:open: tuwunel_database::engine::logger: RocksDB version: 10.2.1
2025-11-03T22:46:04.393393Z DEBUG main:start:open: tuwunel_database::engine::logger: Git sha cf7f65d0b377af019661c240f9165b3ef60640c3
2025-11-03T22:46:04.393400Z DEBUG main:start:open: tuwunel_database::engine::logger: Compile date 2025-11-03 04:51:58
2025-11-03T22:46:04.393406Z DEBUG main:start:open: tuwunel_database::engine::logger: DB SUMMARY
2025-11-03T22:46:04.393414Z DEBUG main:start:open: tuwunel_database::engine::logger: Host name (Env):  b1b42ea3a12b
2025-11-03T22:46:04.393420Z DEBUG main:start:open: tuwunel_database::engine::logger: DB Session ID:  P4WFG9C8RYPA4BA8VTE4
2025-11-03T22:46:04.393505Z DEBUG main:start:open: tuwunel_database::engine::logger: CURRENT file:  CURRENT
2025-11-03T22:46:04.393515Z DEBUG main:start:open: tuwunel_database::engine::logger: IDENTITY file:  IDENTITY
2025-11-03T22:46:04.393528Z DEBUG main:start:open: tuwunel_database::engine::logger: MANIFEST file:  MANIFEST-000238 size: 10528 Bytes
2025-11-03T22:46:04.393565Z DEBUG main:start:open: tuwunel_database::engine::logger: SST files in /var/lib/tuwunel dir, Total Num: 9, files: 000008.sst 000009.sst 000010.sst 000011.sst 000012.sst 000013.sst 000014.sst 000015.sst 000016.sst
2025-11-03T22:46:04.393594Z DEBUG main:start:open: tuwunel_database::engine::logger: Write Ahead Log file in /var/lib/tuwunel: 000237.log size: 0 ;
2025-11-03T22:46:04.393696Z DEBUG main:start:open: tuwunel_database::engine::logger: Compression algorithms supported:
2025-11-03T22:46:04.393727Z DEBUG main:start:open: tuwunel_database::engine::logger: kZSTD supported: 1
2025-11-03T22:46:04.393752Z DEBUG main:start:open: tuwunel_database::engine::logger: kXpressCompression supported: 0
2025-11-03T22:46:04.393777Z DEBUG main:start:open: tuwunel_database::engine::logger: kBZip2Compression supported: 1
2025-11-03T22:46:04.393802Z DEBUG main:start:open: tuwunel_database::engine::logger: kLZ4Compression supported: 1
2025-11-03T22:46:04.393827Z DEBUG main:start:open: tuwunel_database::engine::logger: kZlibCompression supported: 0
2025-11-03T22:46:04.393857Z DEBUG main:start:open: tuwunel_database::engine::logger: kLZ4HCCompression supported: 1
2025-11-03T22:46:04.393882Z DEBUG main:start:open: tuwunel_database::engine::logger: kSnappyCompression supported: 0
2025-11-03T22:46:04.393908Z DEBUG main:start:open: tuwunel_database::engine::logger: Fast CRC32 supported: Not supported on x86
2025-11-03T22:46:04.393933Z DEBUG main:start:open: tuwunel_database::engine::logger: DMutex implementation: pthread_mutex_t
2025-11-03T22:46:04.393962Z DEBUG main:start:open: tuwunel_database::engine::logger: Jemalloc supported: 1
2025-11-03T22:46:04.629865Z DEBUG main:start:open: tuwunel_database::engine::logger: DB pointer 0x7f03cd323c00
2025-11-03T22:46:04.630407Z  INFO main:start:open: tuwunel_database::engine::open: Opened database. columns=95 sequence=19 time=239.667948ms
2025-11-03T22:46:04.645620Z DEBUG main:start: tuwunel_service::server_keys::keypair: Found existing Ed25519 keypair: "9ZNRdk1f"
2025-11-03T22:46:04.645792Z  INFO main:start: tuwunel_service::services: Starting services...
2025-11-03T22:46:04.647404Z DEBUG main:start: tuwunel_service::media::migrations: Checking integrity of media directory
2025-11-03T22:46:04.647443Z ERROR tuwunel: Critical error starting server: I/O error: No such file or directory (os error 2)
at src/main/lib.rs:71 on main ThreadId(1)
in tuwunel::main
Error: I/O error: No such file or directory (os error 2)

Volume contents:

total 5012
-rw-r--r--. 1 root root   1273 Nov  3 13:30 000008.sst
-rw-r--r--. 1 root root   1515 Nov  3 13:30 000009.sst
-rw-r--r--. 1 root root   1259 Nov  3 13:30 000010.sst
-rw-r--r--. 1 root root   1199 Nov  3 13:30 000011.sst
-rw-r--r--. 1 root root   1183 Nov  3 13:30 000012.sst
-rw-r--r--. 1 root root   1171 Nov  3 13:30 000013.sst
-rw-r--r--. 1 root root   1186 Nov  3 13:30 000014.sst
-rw-r--r--. 1 root root   1223 Nov  3 13:30 000015.sst
-rw-r--r--. 1 root root   1217 Nov  3 13:30 000016.sst
-rw-r--r--. 1 root root      0 Nov  3 13:34 000061.log
-rw-r--r--. 1 root root     16 Nov  3 13:34 CURRENT
-rw-r--r--. 1 root root     36 Nov  3 13:30 IDENTITY
-rw-r--r--. 1 root root      0 Nov  3 13:30 LOCK
-rw-r--r--. 1 root root  10032 Nov  3 13:34 MANIFEST-000062
-rw-r--r--. 1 root root 445133 Nov  3 13:33 OPTIONS-000060
-rw-r--r--. 1 root root 445133 Nov  3 13:34 OPTIONS-000064
drwxr-xr-x. 2 root root     24 Nov  3 13:34 archive

Compose:

version: "3.8"

services:
  homeserver:
    image: jevolk/tuwunel:latest
    restart: unless-stopped
    volumes:
      - db:/var/lib/tuwunel
      # - ../files/tuwunel.toml:/etc/tuwunel.toml
    environment:
      TUWUNEL_SERVER_NAME: tuwunel.snugnook.org
      TUWUNEL_DATABASE_PATH: /var/lib/tuwunel
      TUWUNEL_PORT: 6167
      TUWUNEL_MAX_REQUEST_SIZE: 20000000 # in bytes, ~20 MB
      TUWUNEL_ALLOW_REGISTRATION: 'true'
      TUWUNEL_REGISTRATION_TOKEN: 'MY_TOKEN'
      #TUWUNEL_YES_I_AM_VERY_VERY_SURE_I_WANT_AN_OPEN_REGISTRATION_SERVER_PRONE_TO_ABUSE: 'true'
      TUWUNEL_ALLOW_FEDERATION: 'false'
      TUWUNEL_ALLOW_CHECK_FOR_UPDATES: 'true'
      TUWUNEL_TRUSTED_SERVERS: '["matrix.org"]'
      # TUWUNEL_LOG: warn,state_res=warn
      TUWUNEL_ADDRESS: 0.0.0.0
      # TUWUNEL_CONFIG: '/etc/tuwunel.toml'
      TUWUNEL_WELL_KNOWN: |
        {
        client=https://tuwunel.snugnook.org,
        server=tuwunel.snugnook.org:443
        }
    ulimits:
      nofile:
        soft: 1048567
        hard: 1048567

volumes:
  db: {}

[jevolk]

Thank you for reporting and with verbose logging 😊

Are you migrating from another server or is this the first (or second) startup with tuwunel? I don't see a media directory present. The directory is being created too late based on these factors. I will fix this.

In the meantime, you should be able to bypass the issue by setting media_startup_check = false in your config (or in this case, a var like TUWUNEL_MEDIA_STARTUP_CHECK: false). This should allow the directory creation to occur after.

[daudix]

Hi, yep, it was the first startup (and the ones after it). The workaround you provided have worked flawlessly, thanks a bunch!