diff --git a/README.md b/README.md index cc821b9..4089ea1 100644 --- a/README.md +++ b/README.md @@ -30,3 +30,4 @@ Note: You can also refer to [Awesome Minio](https://github.com/minio/awesome-min - [Rclone with Minio](./docs/rclone-with-minio.md) - [Download from Browser with PreSignedGet](./docs/presigned-get-download-from-browser.md) - [Upload via Browser with PreSignedPut](./docs/presigned-put-upload-via-browser.md) +- [How to use Cyberduck with Minio](./docs/how-to-use-cyberduck-with-minio.md) diff --git a/docs/generate-lets-encypt-certificate-using-concert-for-minio.md b/docs/generate-lets-encypt-certificate-using-concert-for-minio.md index 0d0b2c0..2f4df74 100644 --- a/docs/generate-lets-encypt-certificate-using-concert-for-minio.md +++ b/docs/generate-lets-encypt-certificate-using-concert-for-minio.md @@ -57,7 +57,7 @@ total 12 The generated keys via Concert needs to be placed inside users home directory at ``${HOME}/.minio/certs`` ```sh -$ mkdir /home/supernova/.minio/certs/ + $ cp my-certs/private.key /home/supernova/.minio/certs/ $ cp my-certs/public.crt /home/supernova/.minio/certs/ diff --git a/docs/how-to-use-cyberduck-with-minio.md b/docs/how-to-use-cyberduck-with-minio.md new file mode 100644 index 0000000..bf8ff6f --- /dev/null +++ b/docs/how-to-use-cyberduck-with-minio.md @@ -0,0 +1,60 @@ +# How to use Cyberduck with Minio [![Gitter](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/minio/minio?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge) + +In this document you will learn how to carry out basic operations on Minio using Cyberduck. Cyberduck is an open source client for FTP and SFTP, WebDAV, OpenStack Swift, and Amazon S3, available for Mac OS X and Windows (as of version 4.0) licensed under the GPL. + +## Prerequisites + +* Cyberduck is installed and running. If not please download Cyberduck from [here](https://cyberduck.io/). Since Minio is Amazon S3 API compatible you will need to download [Generic S3 Profiles](https://trac.cyberduck.io/wiki/help/en/howto/s3#HTTP). We are downloading ``HTTP`` profile for this setup. + +* Minio Server is running on localhost on port 9000 in ``HTTP``, follow [Minio quickstart guide](https://docs.minio.io/docs/minio-quickstart-guide) for installing Minio. + +_NOTE:_ You can also run Minio in ``HTTPS``, follow this [guide](https://docs.minio.io/docs/generate-let-s-encypt-certificate-using-concert-for-minio) along with Cyberduck HTTPS [Generic S3 Profiles](https://trac.cyberduck.io/wiki/help/en/howto/s3#HTTPS) + +### 1. Add Minio authentication in Cyberduck + +Click open connection, select ``HTTP`` + +![I_IMAGE](https://github.com/minio/cookbook/blob/master/docs/screenshots/cyberduck/defaultdashboard.jpg?raw=true) + +### 2. Replace the existing ``AWS S3`` details with your local ``Minio`` credentials to: + +![MINIO_DASH](https://github.com/minio/cookbook/blob/master/docs/screenshots/cyberduck/connecttominio.jpg?raw=true) + +### 3. Click on the ``connect`` tab to establish connection. + +Once the connection is established you can explore operations listed below. + +#### List Bucket + +![B_LISTING](https://github.com/minio/cookbook/blob/master/docs/screenshots/cyberduck/allbuckets.jpg?raw=true) + +#### Upload Object + +![U_OBJECT](https://github.com/minio/cookbook/blob/master/docs/screenshots/cyberduck/uploadobject.jpg?raw=true) + +#### Download Object + +![D_OBJECT](https://github.com/minio/cookbook/blob/master/docs/screenshots/cyberduck/downloadobject.jpg?raw=true) + +#### Delete Object + +![D_OBJECT](https://github.com/minio/cookbook/blob/master/docs/screenshots/cyberduck/deleteobject.jpg?raw=true) + +#### Download bucket + +![D_BUCKET](https://github.com/minio/cookbook/blob/master/docs/screenshots/cyberduck/downloadbucket.jpg?raw=true) + +#### Mirror Bucket + +![M_BUCKET](https://github.com/minio/cookbook/blob/master/docs/screenshots/cyberduck/mirror.jpg?raw=true) + +#### Delete Bucket + +![D_BUCKET](https://github.com/minio/cookbook/blob/master/docs/screenshots/cyberduck/deletebucket.jpg?raw=true) + +### 3. Explore Further + +* [Minio Client complete guide](https://docs.minio.io/docs/minio-client-complete-guide) +* [Cyberduck project homepage](https://cyberduck.io) + + diff --git a/docs/restic-with-minio.md b/docs/restic-with-minio.md index b864075..3c932a1 100644 --- a/docs/restic-with-minio.md +++ b/docs/restic-with-minio.md @@ -33,7 +33,7 @@ $ ./restic -r s3:http://localhost:9000/resticbucket init ``` -Copy backups from the local machine to the bucket on minio server. +Copy backups from the local machine to the bucket on Minio server. ```sh diff --git a/docs/screenshots/cyberduck/allbuckets.jpg b/docs/screenshots/cyberduck/allbuckets.jpg new file mode 100644 index 0000000..1a909c9 Binary files /dev/null and b/docs/screenshots/cyberduck/allbuckets.jpg differ diff --git a/docs/screenshots/cyberduck/connecttominio.jpg b/docs/screenshots/cyberduck/connecttominio.jpg new file mode 100644 index 0000000..e779f2b Binary files /dev/null and b/docs/screenshots/cyberduck/connecttominio.jpg differ diff --git a/docs/screenshots/cyberduck/defaultdashboard.jpg b/docs/screenshots/cyberduck/defaultdashboard.jpg new file mode 100644 index 0000000..8997204 Binary files /dev/null and b/docs/screenshots/cyberduck/defaultdashboard.jpg differ diff --git a/docs/screenshots/cyberduck/deletebucket.jpg b/docs/screenshots/cyberduck/deletebucket.jpg new file mode 100644 index 0000000..a58bde0 Binary files /dev/null and b/docs/screenshots/cyberduck/deletebucket.jpg differ diff --git a/docs/screenshots/cyberduck/deleteobject.jpg b/docs/screenshots/cyberduck/deleteobject.jpg new file mode 100644 index 0000000..35b54a6 Binary files /dev/null and b/docs/screenshots/cyberduck/deleteobject.jpg differ diff --git a/docs/screenshots/cyberduck/downloadbucket.jpg b/docs/screenshots/cyberduck/downloadbucket.jpg new file mode 100644 index 0000000..65e24a1 Binary files /dev/null and b/docs/screenshots/cyberduck/downloadbucket.jpg differ diff --git a/docs/screenshots/cyberduck/downloadobject.jpg b/docs/screenshots/cyberduck/downloadobject.jpg new file mode 100644 index 0000000..e643584 Binary files /dev/null and b/docs/screenshots/cyberduck/downloadobject.jpg differ diff --git a/docs/screenshots/cyberduck/mirror.jpg b/docs/screenshots/cyberduck/mirror.jpg new file mode 100644 index 0000000..a8b2e59 Binary files /dev/null and b/docs/screenshots/cyberduck/mirror.jpg differ diff --git a/docs/screenshots/cyberduck/uploadobject.jpg b/docs/screenshots/cyberduck/uploadobject.jpg new file mode 100644 index 0000000..c84cb13 Binary files /dev/null and b/docs/screenshots/cyberduck/uploadobject.jpg differ diff --git a/docs/setup-apache-http-proxy-with-minio.md b/docs/setup-apache-http-proxy-with-minio.md index 78c77c1..ff7ec0f 100644 --- a/docs/setup-apache-http-proxy-with-minio.md +++ b/docs/setup-apache-http-proxy-with-minio.md @@ -2,7 +2,7 @@ Apache HTTP is an open source web server and a reverse proxy server. -In this recipe we will learn how to set up Apache HTTP with mod_proxy module for connecting to Minio Server. We are goint to set up a new VirtualHost for example.com +In this recipe we will learn how to set up Apache HTTP with mod_proxy module for connecting to Minio Server. We are going to set up a new VirtualHost for example.com ## 1. Prerequisites