FS Buckets configured with Environment Variables

fsb envvar 1

For a long time the only way to configure an FS Bucket for your application was to create a buckets.json file in ./clevercloud/ and specify the configuration in there. Not very Immutable Infrastucture friendly. It ends today.

Because you had to write a file in your code for a specific application, it made your code repository tied to a particular application. Sure there was a workaround with the apps field that allowed us to whitelist applications for each buckets. But it is still more painful than it should be.

Well starting today you can configure FS Buckets using environment variable. Here's what you need to add:

CC_FS_BUCKET=/path/to/folder:bucket_host

So if you have the following file:

[
  {
    "bucket_host": "bucket-c65762b6-4086-4c99-84b0-23eb85695809-fsbucket.services.clever-cloud.com",
    "folder": "/sites/default/files"
  }
]

You can delete it and replace it with the environment variable CC_FS_BUCKET=/sites/default/files:bucket-c65762b6-4086-4c99-84b0-23eb85695809-fsbucket.services.clever-cloud.com.

If you have multiple buckets you can use multiple variables like so:

CC_FS_BUCKET=/path/to/folder:bucket_host
CC_FS_BUCKET_0=/path/to/folder:bucket_host
CC_FS_BUCKET_10=/path/to/folder:bucket_host

Blog

À lire également

See You at Tech Alternatives Nantes

On September 18, 2026, Clever Cloud co-organizes Tech Alternatives Nantes, alongside a dozen companies and three local associations and professional networks.
Événements

Upcoming Events 2026

From September to November, we'll be at conferences and tech events across France and beyond.
Event

Compliance as code: moving our management system documentation into GitLab, from one month to 30 minutes

Updating our security policy set used to take almost a month, once a year. Today it takes 30 minutes. And the result is more reliable than it was.
Engineering