[Bug]: initialBuckets environment variable not respected

[hitsthings]

S3Mock Version

latest

Usage Mode

Docker

Description

I believe the initialBuckets environment variable is no longer respected or no longer parses correctly.

Steps to Reproduce

I am using Docker Compose and starting S3Mock like:

services:
  s3-local:
    image: adobe/s3mock:latest
    environment:
      - initialBuckets=released-dev-private,released-dev-public,roadmaps-dev-data,released-dev-api-cache
      - retainFilesOnExit=true
      - root=/var/lib/s3mock/data
    ports:
      - '${S3_MOCK_PORT:-9090}:9090' # http
      - '${S3_MOCK_HTTPS_PORT:-9191}:9191' # https
    volumes:
      - './docker/s3mock:/var/lib/s3mock/data'

Since I am using latest, I automatically got updated to 5.0 recently.

I call:

import {
  ListObjectsV2Command,
  S3Client,
} from '@aws-sdk/client-s3';

await new S3Client(config).send(
        new ListObjectsV2Command({
"Bucket":"released-dev-private",
"Prefix":"draft/96a0ac0a-c409-4191-9be5-fca953958b8f"
}),
      );

from Node.

Expected Behavior

Returns a list of items.

Actual Behavior

Now my app logs:

NoSuchBucket: The specified bucket does not exist.

AWS SDK

AWS SDK v2 (Other language)

Relevant Log Output

/usr/bin/docker logs --details 89f40ad0528ad7d9a6a22eb97ac65fe983b7cbfbf72d55cccabb88261ad277da
 OpenJDK 64-Bit Server VM warning: Ignoring option --illegal-access=warn; support was removed in 17.0
 OpenJDK 64-Bit Server VM warning: Ignoring option ZGenerational; support was removed in 24.0
 
 
   .-')              _   .-')                           .-. .-')  
  ( OO ).           ( '.( OO )_                         \  ( OO ) 
 (_)---\_) .-----.   ,--.   ,--.).-'),-----.    .-----. ,--. ,--. 
 /    _ | /  -.   \  |   `.'   |( OO'  .-.  '  '  .--./ |  .'   / 
 \  :` `. '-' _'  |  |         |/   |  | |  |  |  |('-. |      /, 
  '..`''.)   |_  <   |  |'.'|  |\_) |  |\|  | /_) |OO  )|     ' _)
 .-._)   \.-.  |  |  |  |   |  |  \ |  | |  | ||  |`-'| |  .   \  
 \       /\ `-'   /  |  |   |  |   `'  '-'  '(_'  '--'\ |  |\   \ 
  `-----'  `----''   `--'   `--'     `-----'    `-----' `--' '--' 
 
 
 
 2026-04-08T18:16:03.673Z  INFO 1 --- [           main] c.a.t.s.S3MockApplication$Companion      : Starting S3MockApplication.Companion using Java 25.0.2 with PID 1 (/opt/s3mock.jar started by root in /)
 2026-04-08T18:16:03.676Z  INFO 1 --- [           main] c.a.t.s.S3MockApplication$Companion      : No active profile set, falling back to 1 default profile: "default"
 2026-04-08T18:16:04.680Z  INFO 1 --- [           main] o.s.boot.tomcat.TomcatWebServer          : Tomcat initialized with ports 9191 (https), 9090 (http)
 2026-04-08T18:16:04.692Z  INFO 1 --- [           main] o.apache.catalina.core.StandardService   : Starting service [Tomcat]
 2026-04-08T18:16:04.692Z  INFO 1 --- [           main] o.apache.catalina.core.StandardEngine    : Starting Servlet engine: [Apache Tomcat/11.0.20]
 2026-04-08T18:16:04.710Z  INFO 1 --- [           main] b.w.c.s.WebApplicationContextInitializer : Root WebApplicationContext: initialization completed in 992 ms
 2026-04-08T18:16:05.007Z  INFO 1 --- [           main] o.a.t.util.net.NioEndpoint.certificate   : Connector [https-jsse-nio-9191], TLS virtual host [_default_], certificate type [UNDEFINED] configured from keystore [Set directly - location unknown] using alias [selfsigned] with trust store [null]
 2026-04-08T18:16:05.015Z  INFO 1 --- [           main] o.s.boot.tomcat.TomcatWebServer          : Tomcat started on ports 9191 (https), 9090 (http) with context path '/'
 2026-04-08T18:16:05.188Z  INFO 1 --- [           main] o.s.b.a.e.web.EndpointLinksResolver      : Exposing 0 endpoints beneath base path '/actuator'
 2026-04-08T18:16:05.192Z  INFO 1 --- [           main] c.a.t.s.S3MockApplication$Companion      : Started S3MockApplication.Companion in 1.82 seconds (process running for 2.229)
 2026-04-08T18:16:05.239Z  INFO 1 --- [           main] c.a.t.s3mock.store.StoreConfiguration    : Successfully created "/tmp/s3mockFileStore14340709181321959402" as root folder. Will retain files on exit: false
 2026-04-08T18:20:49.992Z  INFO 1 --- [nio-9090-exec-1] o.a.c.c.C.[Tomcat].[localhost].[/]       : Initializing Spring DispatcherServlet 'dispatcherServlet'
 2026-04-08T18:20:49.993Z  INFO 1 --- [nio-9090-exec-1] o.s.web.servlet.DispatcherServlet        : Initializing Servlet 'dispatcherServlet'
 2026-04-08T18:20:50.125Z  INFO 1 --- [nio-9090-exec-1] o.s.web.servlet.DispatcherServlet        : Completed initialization in 132 ms
 2026-04-08T18:20:50.538Z  INFO 1 --- [nio-9090-exec-1] c.a.t.s3mock.store.StoreConfiguration    : Creating initial bucket .

Additional Context

No response

[hitsthings]

Hmm, I see https://github.com/adobe/S3Mock/blob/s3mock-v4/server/src/main/java/com/adobe/testing/s3mock/store/LegacyStoreProperties.java has it marked as deprecated. But it's also mentioned in https://github.com/adobe/S3Mock/blob/s3mock-v4/server/src/main/java/com/adobe/testing/s3mock/store/StoreProperties.java

S3Mock/server/src/main/kotlin/com/adobe/testing/s3mock/store/StoreConfiguration.kt

Line 85 in 23e8c96

LOG.info("Creating initial bucket {}.", name)

still looks like it has it?

[hitsthings]

Looking at the readme I can see there is now COM_ADOBE_TESTING_S3MOCK_STORE_INITIAL_BUCKETS in the example. I am guessing I should use that name?

[afranken]

you're pulling :latest, which is 5.0.0 now.

in 5.0.0, all configuration properties have been consolidated to a new format:
https://github.com/adobe/S3Mock?tab=readme-ov-file#configuration

[hitsthings]

Thanks, yeah I figured that out. Could be good to mention in the migration section. I am still getting errors after that.

  s3-local:
    image: adobe/s3mock:5.0.0
    environment:
      - COM_ADOBE_TESTING_S3MOCK_STORE_INITIAL_BUCKETS=released-dev-private,released-dev-public,roadmaps-dev-data,released-dev-api-cache
      - COM_ADOBE_TESTING_S3MOCK_STORE_RETAIN_FILES_ON_EXIT=true
      - COM_ADOBE_TESTING_S3MOCK_STORE_ROOT=/var/lib/s3mock/data
    ports:
      - '${S3_MOCK_PORT:-9090}:9090' # http
      - '${S3_MOCK_HTTPS_PORT:-9191}:9191' # https
    volumes:
      - './docker/s3mock:/var/lib/s3mock/data'

gives

2026-04-08T19:44:58.171Z ERROR 1 --- [nio-9090-exec-5] o.a.c.c.C.[.[.[/].[dispatcherServlet]    : Servlet.service() for servlet [dispatcherServlet] in context with path [] threw exception [Request processing failed: org.springframework.beans.factory.UnsatisfiedDependencyException: Error creating bean with name 'bucketController' defined in class path resource [com/adobe/testing/s3mock/controller/ControllerConfiguration.class]: Unsatisfied dependency expressed through method 'bucketController' parameter 0: Error creating bean with name 'bucketService' defined in class path resource [com/adobe/testing/s3mock/service/ServiceConfiguration.class]: Unsatisfied dependency expressed through method 'bucketService' parameter 0: Error creating bean with name 'bucketStore' defined in class path resource [com/adobe/testing/s3mock/store/StoreConfiguration.class]: Failed to instantiate [com.adobe.testing.s3mock.store.BucketStore]: Factory method 'bucketStore' threw exception with message: Instantiation of [simple type, class com.adobe.testing.s3mock.store.BucketMetadata] value failed for JSON property bucketRegion due to missing (therefore NULL) value for creator parameter bucketRegion which is a non-nullable type

Currently trying to figure out what that means. :)

[hitsthings]

Looks like removing the existing data might fix it. Fair enough :)

[afranken]

yes, 5.0.0 can't read data created by earlier versions.
Most likely it's the DisplayName property that AWS removed last year. I decided to leave it in 4.x and change the data persistence layer in 5.x

[afranken]

Thanks, yeah I figured that out. Could be good to mention in the migration section. I am still getting errors after that.

the wording is probably too cryptic:
https://github.com/adobe/S3Mock?tab=readme-ov-file#4x-to-5x-current

Legacy properties removed: Old-style configuration properties have been removed

you would have to know that the v4 README.md listed the properties you used as "legacy":
https://github.com/adobe/S3Mock/tree/s3mock-v4?tab=readme-ov-file#s3mock-configuration-options

I'll look into improving the wording.

[hitsthings]

Legacy properties removed: Old-style configuration properties have been removed

Ah makes sense!

Thanks for the help with this. Working fine now with fresh data. It's very useful having this for testing, so thanks very much for maintaining it!