Help setting up S3 Storage / uninitialized constant Store::Provider::S3

[dwehrmann]

• Used Zammad version: 6.1.0-1701845240.5a81e629.buster
• Used Zammad installation type: package
• Operating system: Debian

I changed /config/storage.yml as follows:

amazon:
  service: S3
  access_key_id: redacted
  secret_access_key: redacted
  region: eu-central-1
  bucket: bucket name

restarted zammad
and selected S3 as Storage mode from the web UI settings

Expected behavior:

• Attachments are saved to the S3 bucket

Actual behavior:

• Error pops up “file cannot be uploaded”
• zammad run rails r 'Rails.logger = Logger.new(STDOUT); pp Store::Provider::S3.ping?'
  fails with
  uninitialized constant Store::Provider::S3

Can anybody help me understand what’s going on? Thanks!

[fliebe92]

Hi @dwehrmann. Please make sure to read the S3 part in the documentation.

[dwehrmann]

Hi @fliebe92
Actually, I did and I followed the steps.
Did you see anything I missed? If you are referring to the key “amazon”, I also tried “s3” as indicated in the docs. Made no difference.

Thanks!

[tschaefer]

Hi @dwehrmann,

the file path is config/zammad/storage.yml.

s3:
  access_key_id: redacted
  secret_access_key: redacted
  region: eu-central-1
  endpoint: https://s3.eu-central-1.amazonaws.com
  bucket: bucket name

You can check the validity via the console.

rails r 'Rails.logger = Logger.new(STDOUT); pp Store::Provider::S3.ping?'

In the case of package installation.

zammad run rails r 'Rails.logger = Logger.new(STDOUT); pp Store::Provider::S3.ping?

You also have to provide an endpoint in the config. This is needed because we support any S3-compatible service. See the following link for the Amazon region endpoints, Amazon Simple Storage Service endpoints and quotas - AWS General Reference

[dwehrmann]

Hi @tschaefer

Thank you! I am lost about the file path, I think that’s the problem I’m running into:

I saw a storage.yml in /opt/zammad/config/– but obviously that is not correct.
I do not have a zammad dir in /opt/zammad/config/

From the docs, I assumed this was located in the zammad installation directory /opt/zammad/– is that wrong?

[tschaefer]

The file config/storage.yml is the Rails default file, we never used it. Maybe we’ll remove it to avoid confusion.

[tschaefer]

Ah, I see, you’re still on Zammad 6.1, you need Zammad 6.2. The S3 storage is not available in 6.1.

[dwehrmann]

AH! That explains everything. Thank you!