Fix Non-Amazon, S3 Compatible Services docs (add STORAGE_S3_REGION) #4906

New Issue

OVERLORD · 2026-02-05T09:25:18+03:00

OVERLORD commented

2026-02-05 09:25:18 +03:00

Originally created by @Meettya on GitHub (Aug 9, 2024).

Describe the Bug

Create self-hosted Minio bucket, get correct keys.
Set all values to .env as described at doc https://www.bookstackapp.com/docs/admin/upload-config/#non-amazon-s3-compatible-services

As result get 500 error on front-end and 400 error at laravel log

[previous exception] [object] (GuzzleHttp\\Exception\\ClientException(code: 400): Client error: HEAD https://domain.name/bucketname/uploads/images/gallery/2024-08/2024-08-08-131815.pngresulted in a400 Bad Request response at /app/www/vendor/guzzlehttp/guzzle/src/Exception/RequestException.php:113)

Solution
add STORAGE_S3_REGION=you-region to .env file

after this all work flawless.

PS. May be its optional setings and depends on Minio settings, but any way its seems should declared at docs.

Steps to Reproduce

Create any empty page
Try to add image

Expected Behaviour

Image should upload

Screenshots or Additional Context

No response

Browser Details

No response

Exact BookStack Version

v24.05.3

Originally created by @Meettya on GitHub (Aug 9, 2024). ### Describe the Bug 1) Create self-hosted Minio bucket, get correct keys. 2) Set all values to .env as described at doc https://www.bookstackapp.com/docs/admin/upload-config/#non-amazon-s3-compatible-services As result get 500 error on front-end and 400 error at laravel log `[previous exception] [object] (GuzzleHttp\\Exception\\ClientException(code: 400): Client error: `HEAD https://domain.name/bucketname/uploads/images/gallery/2024-08/2024-08-08-131815.png` resulted in a `400 Bad Request` response at /app/www/vendor/guzzlehttp/guzzle/src/Exception/RequestException.php:113)` **Solution** add `STORAGE_S3_REGION=you-region` to .env file after this all work flawless. PS. May be its optional setings and depends on Minio settings, but any way its seems should declared at docs. ### Steps to Reproduce 1. Create any empty page 2. Try to add image ### Expected Behaviour Image should upload ### Screenshots or Additional Context _No response_ ### Browser Details _No response_ ### Exact BookStack Version v24.05.3

OVERLORD added the 🐛 Bug label 2026-02-05 09:25:18 +03:00

OVERLORD closed this issue

2026-02-05 09:25:20 +03:00

OVERLORD commented

2026-02-05 09:25:23 +03:00

@ssddanbrown commented on GitHub (Aug 9, 2024):

Hi @Meettya,

I'm not sure that's a required option, and think something else may have been at play on your instance.
Just yesterday I tested BookStack with Minio, and this was not required.
I recorded my full integration and test process here:
https://foss.video/w/9noJP3x5gnmQ4bNUAg47qs

I don't want to document environment and platform specific edge-cases/issues within our own documentation, as it's intended to be fairly platform abstract and I don't want to indicate official support is provided for specific platforms.

@ssddanbrown commented on GitHub (Aug 9, 2024): Hi @Meettya, I'm not sure that's a required option, and think something else may have been at play on your instance. Just yesterday I tested BookStack with Minio, and this was not required. I recorded my full integration and test process here: https://foss.video/w/9noJP3x5gnmQ4bNUAg47qs I don't want to document environment and platform specific edge-cases/issues within our own documentation, as it's intended to be fairly platform abstract and I don't want to indicate official support is provided for specific platforms.

OVERLORD commented

2026-02-05 09:25:26 +03:00

@Meettya commented on GitHub (Aug 9, 2024):

Hi @ssddanbrown

Looks reasonably. Ok, seems it to be enough just close issue and remain it for search, in edge case maybe someone can find it here.
Anyway thank you :)

@Meettya commented on GitHub (Aug 9, 2024): Hi @ssddanbrown Looks reasonably. Ok, seems it to be enough just close issue and remain it for search, in edge case maybe someone can find it here. Anyway thank you :)

Sign in to join this conversation.

Branches Tags

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: starred/BookStack#4906