diff --git a/doc/book/connect/apps/index.md b/doc/book/connect/apps/index.md index f40c1bfb..6aadc36e 100644 --- a/doc/book/connect/apps/index.md +++ b/doc/book/connect/apps/index.md @@ -578,13 +578,14 @@ As a first step we need to create a bucket and a key for Ente: ```bash garage bucket create ente garage key create ente-key -garage bucket allow ente --read --write --key ente-key +# For the CORS setup to work, the key needs to be --owner as well, at least temporarily. +garage bucket allow ente --read --write --owner --key ente-key ``` We also need to setup some CORS rules to allow the Ente frontend to access the bucket: ```bash -export CORS='{"CORSRules":[{"AllowedHeaders":["*"],"AllowedMethods":["GET"],"AllowedOrigins":["*"]}]}' +export CORS='{"CORSRules":[{"AllowedHeaders":["*"],"AllowedMethods":["GET", "PUT", "POST", "DELETE"],"AllowedOrigins":["*"], "ExposeHeaders":["ETag"]}]}' aws s3api put-bucket-cors --bucket ente --cors-configuration $CORS ``` @@ -600,13 +601,13 @@ hardcoded-ott: local-domain-suffix: "@example.com" # Your domain local-domain-value: 123456 # Custom One-Time Password since we are not sending mail by default key: - # You might want to change those next 3 which are the default one - encryption: yvmG/RnzKrbCb9L3mgsmoxXr9H7i2Z4qlbT0mL3ln4w= + # WARNING -- You MUST CHANGE the values below # Someone has made an image that can do it for you : https://github.com/EdyTheCow/ente-selfhost/blob/main/images/ente-server-tools/Dockerfile - hash: KXYiG07wC7GIgvCSdg+WmyWdXDAn6XKYJtp/wkEU7x573+byBRAYtpTP0wwvi8i/4l37uicX1dVTUzwH3sLZyw== -jwt: # Simply build it yourself or run docker run --rm ghcr.io/edythecow/ente-server-tools go run tools/gen-random-keys/main.go - secret: i2DecQmfGreG6q1vBj5tCokhlN41gcfS2cjOs9Po-u8= + encryption: yvmG/RnzKrbCb9L3mgsmoxXr9H7i2Z4qlbT0mL3ln4w= # CHANGE THIS VALUE + hash: KXYiG07wC7GIgvCSdg+WmyWdXDAn6XKYJtp/wkEU7x573+byBRAYtpTP0wwvi8i/4l37uicX1dVTUzwH3sLZyw== # CHANGE THIS VALUE +jwt: + secret: i2DecQmfGreG6q1vBj5tCokhlN41gcfS2cjOs9Po-u8= # CHANGE THIS VALUE ``` The full configuration file can be found [here](https://github.com/ente-io/ente/blob/main/server/configurations/local.yaml) @@ -643,11 +644,11 @@ s3: # default to true if you set "are_local_buckets: true" # use_path_style_urls: true - b2-eu-cen: # Don't change this key, it seems to be hardcoded + b2-eu-cen: # Don't change this key, it is hardcoded key: secret: - endpoint: garage:3900 - region: garage + endpoint: garage:3900 # publically accessible endpoint of your garage instance + region: garage bucket: use_path_style: true # you can specify secondary locations, names are hardcoded as well @@ -657,7 +658,6 @@ s3: # and you can also specify a bucket to be used for embeddings, preview etc.. # default to the first bucket # derived-storage: wasabi-eu-central-2-derived - ``` Finally you can run it with Docker :