Overview
MinIO AIStor is a high-performance, S3-compatible object storage server that you can self-host. It gives you complete control over your data while maintaining compatibility with S3 APIs, making it perfect for private cloud deployments or when you need full data sovereignty. Key features:- Self-hosted - Complete control over your data and infrastructure
- S3-compatible API - Easy integration with existing S3 tools and libraries
- High performance - Optimized for speed and efficiency
- Data sovereignty - Keep your data on your own infrastructure
- Enterprise features - Advanced security, monitoring, and management
MinIO integration is available only if the Cloud Storage plugin is purchased from the Aikeedo Marketplace.
Prerequisites
Before configuring MinIO:- Cloud Storage Plugin - Purchase from Aikeedo Marketplace
- MinIO AIStor Installation - Follow the official installation guide
- Bucket - Create a bucket for your files
- Access Keys - Generate API credentials
- Network Access - Ensure Aikeedo can reach MinIO
Configuration Steps
1
Access AIStor Console
Open the AIStor web console:
- Navigate to your AIStor console URL
- Login with your admin credentials
- Ensure you have the necessary permissions for bucket and access key management
For detailed installation and setup instructions, refer to the official AIStor installation guide.
2
Create Bucket
Create a bucket for your files:
- In the AIStor console, go to Buckets
- Click Create Bucket
- Enter bucket name (e.g.,
aikeedo-files
) - Choose access policy (Private recommended)
- Click Create Bucket
For detailed bucket management, refer to the official bucket management documentation.
3
Create Access Keys
Generate API credentials:
- Go to Access Keys in the AIStor console
- Click Create Access Key
- Enter a name for the key (e.g.,
aikeedo-access
) - Copy the Access Key and Secret Key
- Save credentials securely
For detailed access management, refer to the official IAM documentation.
4
Configure in Aikeedo
In your admin panel:
- Go to Settings > Cloud storage > MinIO
- Toggle Status to Enabled
- Enter Origin endpoint:
http://your-server:port
(use your configured port) - Enter Custom domain (optional domain for MinIO)
- Enter Bucket name: Your MinIO bucket name
- Enter Path prefix (optional subfolder)
- Enter Access key: Your MinIO access key
- Enter Secret key: Your MinIO secret key
- Click Save changes
Configuration Fields
Required fields:- Origin endpoint - MinIO server endpoint URL (e.g.,
http://your-server:port
) - Bucket name - Name of your MinIO bucket
- Access key - MinIO access key for authentication
- Secret key - MinIO secret key for authentication
- Custom domain - Custom domain for serving files through reverse proxy
- Path prefix - Optional subfolder within your bucket for organizing files
For detailed server configuration options, refer to the official core settings documentation.
Troubleshooting
Connection refused:- Check if MinIO server is running
- Verify the configured port is open and accessible
- Check firewall settings
- Ensure correct endpoint URL
- Verify access keys are correct
- Check bucket name matches exactly
- Ensure bucket exists and is accessible
- Verify network connectivity
- Check server resources (CPU, RAM, disk)
- Verify network latency between Aikeedo and MinIO
- Ensure data directory is accessible
- Check for disk errors