[Support Request]: S3 configuration is unclear in docs #2543

New Issue

OVERLORD · 2026-02-05T04:28:32+03:00

OVERLORD commented

2026-02-05 04:28:32 +03:00

Originally created by @chrisaalid on GitHub (Dec 28, 2021).

Attempted Debugging

I have read the debugging page

Searched GitHub Issues

I have searched GitHub for the issue.

Describe the Scenario

Hello — I'm trying to configure Bookstack to use S3 for image uploads, per the documentation.

I cannot get it to work and I suspect I'm not providing the right values for bucket & region, but the format of the value Bookstack expects is unclear from the documentation.

Is bucket supposed to be the full https://<bucket-name>.s3.us-east-2.amazonaws.com? or just <bucket-name>?
Is region supposed to be a full us-east-2.amazonaws.com or just us-east-2?

Could someone provide insight into the expected format for those? An update to the docs with an example configuration would be helpful as well.

Exact BookStack Version

v21.08.3

Log Content

No response

PHP Version

No response

Hosting Environment

Ubuntu 20.04 (LTS) x64, installed via official installation script

Originally created by @chrisaalid on GitHub (Dec 28, 2021). ### Attempted Debugging - [X] I have read the debugging page ### Searched GitHub Issues - [X] I have searched GitHub for the issue. ### Describe the Scenario Hello — I'm trying to configure Bookstack to use S3 for image uploads, [per the documentation](https://www.bookstackapp.com/docs/admin/upload-config/). I cannot get it to work and I suspect I'm not providing the right values for bucket & region, but the format of the value Bookstack expects is unclear from the documentation. - Is `bucket` supposed to be the full `https://<bucket-name>.s3.us-east-2.amazonaws.com`? or just `<bucket-name>`? - Is `region` supposed to be a full `us-east-2.amazonaws.com` or just `us-east-2`? Could someone provide insight into the expected format for those? An update to the docs with an example configuration would be helpful as well. ### Exact BookStack Version v21.08.3 ### Log Content _No response_ ### PHP Version _No response_ ### Hosting Environment Ubuntu 20.04 (LTS) x64, installed via official installation script

OVERLORD added the 🐕 Support label 2026-02-05 04:28:32 +03:00

OVERLORD closed this issue

2026-02-05 04:28:37 +03:00

OVERLORD commented

2026-02-05 04:28:41 +03:00

@ssddanbrown commented on GitHub (Jan 1, 2022):

Hi @chrisaalid,

Bucket is just <bucket-name>.
Region is just us-east-2.

I won't update the docs yet with an example, as I don't want to complicate them where this has not been previously reported as an issue, since I don't think there's any suggestion these values would be urls, but I'll keep this in mind in the event it becomes a common question.

Since the question has been answered I'll close this off but just shout if further clarification is needed.

@ssddanbrown commented on GitHub (Jan 1, 2022): Hi @chrisaalid, - Bucket is just `<bucket-name>`. - Region is just `us-east-2`. I won't update the docs yet with an example, as I don't want to complicate them where this has not been previously reported as an issue, since I don't think there's any suggestion these values would be urls, but I'll keep this in mind in the event it becomes a common question. Since the question has been answered I'll close this off but just shout if further clarification is needed.

Sign in to join this conversation.

Branches Tags

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: starred/BookStack#2543