search

BookStackApp / BookStack

A platform to create documentation/wiki content built with PHP & Laravel
https://www.bookstackapp.com/
MIT License
15.43k stars 1.94k forks source link

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

Closed Meettya closed 3 months ago

Meettya commented 3 months ago

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.pngresulted in a400 Bad Requestresponse 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

ssddanbrown commented 3 months ago

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.

Meettya commented 3 months ago

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 :)