aboutsummaryrefslogtreecommitdiff
path: root/doc/book/connect/cli.md
diff options
context:
space:
mode:
authorAlex Auvolat <alex@adnab.me>2023-03-13 16:14:13 +0100
committerAlex Auvolat <alex@adnab.me>2023-03-13 16:14:13 +0100
commitf37ec584b6009b16d1c7f06918889954b22f5afb (patch)
treeaa39b41d63358277d61f2cb92ef9565a97c1c901 /doc/book/connect/cli.md
parent40fa1242f080ba69159607c47f46d47c30267285 (diff)
parentdc6be3983300ee3ee10f601cfc04a06563d86f48 (diff)
downloadgarage-f37ec584b6009b16d1c7f06918889954b22f5afb.tar.gz
garage-f37ec584b6009b16d1c7f06918889954b22f5afb.zip
Merge branch 'main' into rustversion-label
Diffstat (limited to 'doc/book/connect/cli.md')
-rw-r--r--doc/book/connect/cli.md21
1 files changed, 21 insertions, 0 deletions
diff --git a/doc/book/connect/cli.md b/doc/book/connect/cli.md
index 74e2d7ed..9b74bb5d 100644
--- a/doc/book/connect/cli.md
+++ b/doc/book/connect/cli.md
@@ -12,6 +12,7 @@ These tools are particularly suitable for debug, backups, website deployments or
| [AWS CLI](#aws-cli) | ✅ | Recommended |
| [rclone](#rclone) | ✅ | |
| [s3cmd](#s3cmd) | ✅ | |
+| [s5cmd](#s5cmd) | ✅ | |
| [(Cyber)duck](#cyberduck) | ✅ | |
| [WinSCP (libs3)](#winscp) | ✅ | CLI instructions only |
| [sftpgo](#sftpgo) | ✅ | |
@@ -178,6 +179,26 @@ s3cmd put /tmp/hello.txt s3://my-bucket/
s3cmd get s3://my-bucket/hello.txt hello.txt
```
+## `s5cmd`
+
+Configure a credentials file as follows:
+
+```bash
+export AWS_ACCESS_KEY_ID=GK...
+export AWS_SECRET_ACCESS_KEY=
+export AWS_DEFAULT_REGION='garage'
+export AWS_ENDPOINT='http://localhost:3900'
+```
+
+After adding these environment variables in your shell, `s5cmd` can be used
+with:
+
+```bash
+s5cmd --endpoint-url=$AWS_ENDPOINT ls
+```
+
+See its usage output for other commands available.
+
## Cyberduck & duck {#cyberduck}
Both Cyberduck (the GUI) and duck (the CLI) have a concept of "Connection Profiles" that contain some presets for a specific provider.