@@ -578,6 +578,37 @@ Syntax `;unset notify`
578578Do not notify when your ship name is mentioned.
579579
580580
581+## S3 {#s3}
582+
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).
584+
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).
586+
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.
588+
589+### Bucket Setup
590+
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.
592+
593+### Add your credentials: Landscape
594+
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!
596+
597+### Add your credentials: Dojo
598+
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.
600+
601+```
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'
608+```
609+
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.
611+
581612## Shell {#using-the-shell}
582613
583614The Dojo is our shell; it processes system commands and returns output. It's a