@@ -578,6 +578,37 @@ Syntax `;unset notify`
578Do not notify when your ship name is mentioned.
578Do not notify when your ship name is mentioned.
583+Amazon S3, which stands for Amazon Simple Storage Service, is a technology that was introduced by Amazon Web Services for cloud storage that has since been extended more broadly into a [standard programming interface](https://en.wikipedia.org/wiki/Amazon_S3#S3_API_and_competing_services).
585+Our S3 support lets you store credentials for your S3 object storage buckets on your Urbit ship; once you have done so, you will get additional functionality for uploading your own media within Chat and Groups (for avatars).
587+To enable S3 support on your ship you'll need to first set up a bucket, and then add its credentials to Landscape using *either* Landscape or the Dojo.
591+If you’re using AWS, it will have to support signature v2, not v4. We've found DigitalOcean's Spaces to work well also. The bucket has to be publicly readable, allow CORS from `*` origins, allow GET and PUT methods, and allow `*` headers. Your provider should have details on setting access permissions and CORS.
593+### Add your credentials: Landscape
595+Navigate to your `https://<your-ship-url>/~profile/settings`, or click your sigil in the upper-right corner of the window. Fill out the **S3 Credentials** and **S3 Buckets** sections and you're all set!
597+### Add your credentials: Dojo
599+Once you have gotten your bucket setup, poke the `s3-store` on your ship with your details. You can do this in Dojo or in web Dojo.
602+:s3-store|set-endpoint 'endpoint.mys3provider.com'
603+:: AWS endpoint example: s3-us-west-2.amazonaws.com
604+:: Digital Ocean endpoint example: sfo2.digitaloceanspaces.com
605+:s3-store|set-access-key-id 'MYACCESSKEYID'
606+:s3-store|set-secret-access-key 'MYSECRETACCESSKEY'
607+:s3-store|set-current-bucket 'yourbucketname'
610+Done! If you need to peek at s3-store’s state, you can always run :s3-store +dbug (inside Dojo, not web Dojo, unfortunately). You’ll see the additional functionality appear in Groups and Chat.
581## Shell {#using-the-shell}
612## Shell {#using-the-shell}
583The Dojo is our shell; it processes system commands and returns output. It's a
614The Dojo is our shell; it processes system commands and returns output. It's a