## Overview
Cyberduck is a cloud storage browser for Mac and Windows with support for FTP, SFTP, WebDAV, Amazon S3, and many other protocols. This guide will walk you through configuring Cyberduck to work with Rabata.io's S3 storage.
## Prerequisites
- A Rabata.io account with active access keys
- Cyberduck installed on your system (macOS or Windows)
- At least one bucket created in your Rabata.io account
## Installation
### Download Cyberduck
Download the latest version of Cyberduck for your operating system:
- **macOS**: [Download from cyberduck.io](https://cyberduck.io/download/)
- **Windows**: [Download from cyberduck.io](https://cyberduck.io/download/)
### Install Cyberduck
Follow the standard installation process for your operating system:
#### macOS
1. Open the downloaded `.zip` file
2. Drag Cyberduck to your Applications folder
3. Launch Cyberduck from Applications
#### Windows
1. Run the downloaded installer
2. Follow the installation wizard
3. Launch Cyberduck from the Start menu
## Configuration
#### Step 1: Open Connection Dialog
1. Launch Cyberduck
2. Click the **Open Connection** button in the toolbar (or press `Cmd+O` on macOS / `Ctrl+O` on Windows)
#### Step 2: Select Protocol
1. In the dropdown menu at the top, select **Amazon S3**
#### Step 3: Configure Connection Settings
Enter the following information:
- **Server**: `s3.us-east-1.rabata.io`
- **Port**: `443` (default)
- **Access Key ID**: Your Rabata.io access key ID
- **Secret Access Key**: Your Rabata.io secret access key
#### Step 4: Connect
Click **Connect** to establish the connection to Rabata.io.
### Step 5: Creating a Bookmark
1. Choose **Bookmark → New Bookmark** from the menu (or press `Cmd+B` on macOS / `Ctrl+B` on Windows)
2. Select **Amazon S3** as the protocol
Detail will be filled with your existing connection settings when you adding new bookmark:
- **Nickname**: Give your bookmark a memorable name (e.g., "Rabata.io Storage")
- **Server**: `s3.us-east-1.rabata.io`
- **Access Key ID**: Your Rabata.io access key ID
- **Path**: (Optional) Enter `/bucket-name` to open a specific bucket by default
#### Step 6: Save Credentials
1. Close the bookmark window
2. When prompted, enter your Secret Access Key
3. Check **Save password** to store it in your system keychain (recommended for convenience)
## Working with Buckets and Objects
### Viewing Buckets
Once connected, you'll see a list of all your Rabata.io buckets. The interface shows:
- Bucket names
- Creation dates
- Region information (currently us-east-1)
### Creating a New Bucket
1. Right-click in the bucket list
2. Select **New Folder** (buckets appear as folders in Cyberduck)
3. Enter a unique bucket name following S3 naming conventions:
- 3-63 characters long
- Only lowercase letters, numbers, and hyphens
- Must start and end with a letter or number
4. Click **Create**
### Uploading Files
There are several ways to upload files to your Rabata.io buckets:
#### Drag and Drop
1. Navigate to the desired bucket
2. Drag files from your file explorer directly into Cyberduck
3. The upload will start automatically
#### Upload Button
1. Navigate to the desired bucket
2. Click the **Upload** button in the toolbar
3. Select files to upload
4. Click **Choose**
#### Context Menu
1. Right-click in the bucket
2. Select **Upload...**
3. Choose your files
### Managing Objects
#### Downloading Files
- **Single file**: Double-click to download to your default download location
- **Multiple files**: Select files and click the **Download** button
- **Custom location**: Right-click and select **Download To...**
#### Deleting Objects
1. Select the objects you want to delete
2. Press **Delete** key or right-click and select **Delete**
3. Confirm the deletion
#### Renaming Objects
1. Select the object
2. Press **Enter** or right-click and select **Rename**
3. Enter the new name
4. Press **Enter** to confirm
### Setting Permissions
#### Object ACL
1. Right-click on an object
2. Select **Info**
3. Navigate to the **Permissions** tab
4. Configure access control:
- **Private**: Only you can access
- **Public Read**: Anyone can read the object
- **Public Read/Write**: Anyone can read and write (not recommended)
#### Generating Shareable URLs
1. Right-click on an object
2. Select **Copy URL** to get the direct URL
3. For temporary access, select **Copy HTTP URL** with expiration
## Troubleshooting
### Connection Issues
If you cannot connect to Rabata.io:
1. **Verify credentials**: Ensure your Access Key ID and Secret Access Key are correct
2. **Check server address**: Confirm you're using exactly `s3.us-east-1.rabata.io`
3. **Test network**: Ensure you have internet connectivity
4. **Firewall settings**: Make sure port 443 (HTTPS) is not blocked
### SSL/TLS Certificate Errors
If you encounter certificate warnings:
1. Ensure you're using the latest version of Cyberduck
2. Check your system date and time are correct
3. If the issue persists, contact [Rabata.io support](mailto:support@rabata.io)
### Performance Optimization
For better performance:
1. **Enable parallel transfers**: Preferences → Transfers → Use concurrent connections
2. **Adjust connection limit**: Increase the number of concurrent connections (default is 5)
3. **Use compression**: Enable for text-based files in Preferences → Transfers
### Access Denied Errors
If you receive permission errors:
1. Verify your access keys have the necessary permissions
2. Check bucket policies and ACLs
3. Ensure you're accessing the correct bucket/region
## Next Steps
- Check other [Quickstart Guides](/docs/quickstart/) for programmatic access
- Contact [Rabata.io Support](mailto:support@rabata.io) for assistance
## Additional Resources
- [Cyberduck Documentation](https://docs.cyberduck.io/)
- [Cyberduck CLI](https://duck.sh/) for command-line operations