S3-Compatible Tools
OSS is fully compatible with AWS S3, so you can use any S3-compatible tool with OSS by simply changing the endpoint configuration.
Configuration Requirements
All S3 tools need these OSS settings:
| Setting | Value |
|---|---|
| Endpoint | https://<CustomerId>.oss.swiftserve.com |
| Access Key | Your OSS Access Key |
| Secret Key | Your OSS Secret Key |
| Region | us-east-1 (optional) |
| Path Style | Enabled (important) |
OSS uses Path Style addressing: https://endpoint/bucket/object
Make sure to enable Path Style in your S3 client settings.
Desktop Applications
S3Browser
Platform: Windows
Best for: Windows users, visual bucket management
- Free graphical S3 client
- Drag & drop file operations
- Bucket synchronization features
CloudBerry Explorer
Platform: Windows, macOS, Linux
Best for: Cross-platform file management, backups
- Dual-pane interface
- Advanced sync capabilities
- Professional backup features
Cyberduck
Platform: macOS, Windows
Best for: Simple file transfers, Mac users
- Clean, intuitive interface
- Multi-protocol support
- Free and open source
Command Line Tools
AWS CLI
Platform: All platforms
Best for: Automation, scripting, DevOps
- Official AWS command-line tool
- Full S3 API coverage
- Excellent for automation
S3cmd
Platform: Linux, macOS, Windows
Best for: Advanced command-line users
- Feature-rich CLI tool
- Powerful sync capabilities
- Extensive configuration options
MinIO Client (mc)
Platform: All platforms
Best for: High-performance operations
- Optimized for object storage
- Advanced mirroring features
- JSON output for scripting
Developer SDKs
SDK Integration
Complete programming language support:
- Python (boto3) - Most popular
- Node.js - Web applications
- Java - Enterprise applications
- .NET - Windows applications
- Go - Cloud-native applications
Quick Setup
-
Choose your tool based on needs:
- GUI: S3Browser (Windows) or CloudBerry (cross-platform)
- CLI: AWS CLI (automation) or S3cmd (advanced)
- Development: SDK for your programming language
-
Configure with OSS settings (see table above)
-
Test connection by listing buckets
Tool Comparison
| Tool | Type | Platform | Free | Best Use Case |
|---|---|---|---|---|
| S3Browser | GUI | Windows | ✅ | Simple file management |
| CloudBerry | GUI | Multi | ✅ | Backup & sync |
| Cyberduck | GUI | Mac/Win | ✅ | Casual file transfers |
| AWS CLI | CLI | Multi | ✅ | Automation & scripts |
| S3cmd | CLI | Multi | ✅ | Advanced CLI operations |
| MinIO Client | CLI | Multi | ✅ | High-performance tasks |
Common Use Cases
Backup Solution
# Daily backup with AWS CLI
aws s3 sync /data s3://backup-bucket/$(date +%Y-%m-%d)/ \
--endpoint-url https://<customer-id>.oss.swiftserve.com
Website Deployment
# Deploy static website
aws s3 sync ./dist s3://website-bucket/ \
--endpoint-url https://<customer-id>.oss.swiftserve.com
Application Integration
# Python example
import boto3
s3 = boto3.client('s3', endpoint_url='https://<customer-id>.oss.swiftserve.com')
s3.upload_file('local.txt', 'my-bucket', 'remote.txt')
Troubleshooting
| Issue | Solution |
|---|---|
| Connection fails | Verify endpoint format and credentials |
| Access denied | Check permissions and credential validity |
| Slow transfers | Use multipart upload for large files |
| SSL errors | Update tool version or disable SSL temporarily |
Each tool guide provides detailed setup instructions and usage examples.