minio-s3

n8n node for MinIO S3 operations

Package Information

Released: 9/25/2025
Downloads: 23 weekly / 95 monthly
Latest Version: 1.2.0
Author: Bianca Mestreblack

Available Nodes

MinIO S3
No description available

Documentation

n8n-nodes-minio-s3

This is an n8n node for interacting with MinIO S3 compatible storage services.

MinIO is a High Performance Object Storage service compatible with Amazon S3 APIs.

Features

This node allows you to:

  • Create, delete, and list buckets
  • Upload, download, delete, and list files
  • Create, delete, and list folders

Installation

To install this node via npm:

npm install n8n-nodes-minio-s3

Or follow the installation guide in the n8n documentation for community nodes.

For local development

  1. Clone this repository
  2. Install dependencies:
    npm install
  3. Compile the TypeScript code:
    npm run build
  4. Link the node to your n8n installation:
    npm link
    Then in your n8n installation:
    npm link n8n-nodes-minio-s3

Credentials

To use this node, you need to configure the MinIO S3 credentials:

  • Endpoint: The MinIO server endpoint (without http:// or https://)
  • Access Key: Your MinIO access key
  • Secret Key: Your MinIO secret key
  • Use SSL: Whether to use SSL for the connection
  • Region: The region of the MinIO server (default: us-east-1)
  • Path Style: Use path-style addressing (s3.example.com/bucket/) instead of virtual hosted-style (bucket.s3.example.com). Enable this for MinIO.
  • Ignore SSL Issues: Ignore SSL certificate issues (not recommended for production)
  • Default Bucket Name: The default bucket name to use for operations (optional)

Important: Do not include http:// or https:// in the endpoint field. For example, use play.min.io instead of https://play.min.io. The node connects to port 9000 by default, but will automatically detect other common ports.

Usage

Bucket Operations

  1. Create Bucket: Creates a new bucket with the specified name and region
  2. Delete Bucket: Deletes an existing bucket
  3. Get All Buckets: Lists all buckets in your MinIO instance

File Operations

  1. Upload File: Uploads a file to a bucket
    • You can upload binary data from other nodes or text content
  2. Download File: Downloads a file from a bucket
  3. Delete File: Deletes a file from a bucket
  4. Get All Files: Lists all files in a bucket

Folder Operations

  1. Create Folder: Creates a new folder in a bucket
  2. Delete Folder: Deletes a folder from a bucket
  3. Get All Folders: Lists all folders in a bucket

Example Workflow

You can find example workflows in the examples folder that demonstrate how to use this node:

  • test-workflow.json: Basic workflow to create a bucket
  • complete-test-workflow.json: Complete workflow demonstrating all operations

Troubleshooting

Endpoint Invalid Error

If you're getting an "endpoint invalid" error, make sure:

  1. You're not including http:// or https:// in the endpoint field
  2. The endpoint doesn't end with a trailing slash
  3. The port is correct for your MinIO instance
  4. Your credentials are correct

Connection Refused Error

If you're getting a "connection refused" error:

  1. Check if your MinIO server is running
  2. Verify DNS resolution for your domain
  3. Check firewall settings
  4. Ensure the port is correct and accessible

SSL Certificate Errors

If you're getting SSL certificate errors with a self-signed certificate:

  1. Enable "Ignore SSL Issues" in the credentials
  2. Consider using a valid SSL certificate for production

For detailed troubleshooting steps, see TROUBLESHOOTING.md.

Resources

Compatibility

This node is fully compatible with self-hosted n8n instances and MinIO Open Source self-hosted installations. It is not available in n8n Cloud due to restrictions on community nodes.

MinIO Self-Hosted Configuration

This node is optimized for MinIO self-hosted installations with the following features:

  • Path Style Addressing: Enabled by default for MinIO compatibility
  • SSL Configuration: Support for self-signed certificates with "Ignore SSL Issues" option
  • Flexible Endpoint Configuration: Works with custom domains and IP addresses
  • Region Support: Compatible with MinIO region configuration
  • Enhanced Diagnostics: Improved error messages and connection testing

Development

To develop and test this node:

  1. Clone the repository
  2. Install dependencies with npm install
  3. Build the project with npm run build
  4. Link the package with npm link
  5. In your n8n installation, link the package with npm link n8n-nodes-minio-s3

Publishing to npm

To publish this package to npm:

  1. Create an account at npmjs.com
  2. Update the package.json with your information
  3. Login to npm with npm login
  4. Build the project with npm run build
  5. Publish with npm publish

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

MIT

Changelog

1.1.2

  • Removed bucket name field from file and folder operations
  • Simplified node interface by using default bucket from credentials exclusively
  • Enhanced validation to ensure default bucket is specified in credentials

1.1.1

  • Fixed package configuration to include SVG icon file
  • Ensured MinIO logo is properly displayed in n8n interface

1.1.0

  • Added Default Bucket Name field to credentials for specifying a default bucket
  • Enhanced node logic to use default bucket from credentials when not specified in node
  • Improved user experience by reducing repetitive bucket name entry

1.0.9

  • Added detection for reverse proxy scenarios with unavailable backend
  • Enhanced error messages for proxy server configurations
  • Improved handling of SSL certificate issues with self-signed certificates

1.0.8

  • Added automatic port detection for MinIO servers
  • Enhanced connection logic to test multiple common ports (9000, 80, 443)
  • Improved handling of endpoints that may be behind reverse proxies
  • Fixed connection issues with sslip.io endpoints

1.0.7

  • Fixed endpoint parsing to handle URLs that already include port numbers
  • Improved connection logic to extract port from endpoint when specified
  • Resolved connection issues with endpoints like z0w8c4wgckwwokccco8goook.37.60.224.93.sslip.io

1.0.6

  • Added connection testing before operations to ensure server availability
  • Improved error messages with more specific connection failure details
  • Enhanced diagnostics for network connectivity issues

1.0.5

  • Removed port configuration option and fixed port to 9000 as requested by user
  • Updated documentation to reflect fixed port configuration
  • Simplified connection logic by removing dynamic port handling

1.0.4

  • Added enhanced connection diagnostics with DNS lookup and port checking
  • Improved error messages with more specific troubleshooting information
  • Added pre-connection validation to identify network issues early

1.0.3

  • Added full compatibility with MinIO self-hosted installations
  • Added Path Style addressing option (enabled by default for MinIO)
  • Added SSL certificate handling with "Ignore SSL Issues" option
  • Enhanced error handling for SSL certificate errors

1.0.2

  • Improved error handling for connection issues
  • Better validation of endpoint and credentials
  • Enhanced error messages for common connection problems

1.0.1

  • Fixed endpoint validation issues
  • Removed protocol from endpoint automatically
  • Added troubleshooting guide

Discussion