MinIO icon

MinIO

MinIO operation

Overview

This node generates a presigned PUT URL for uploading an object to a MinIO bucket. A presigned PUT URL allows users or external systems to upload files directly to a specified bucket and key in MinIO, without needing direct access to credentials. This is useful for securely allowing uploads from clients, web applications, or third-party services.

Common scenarios:

  • Allowing end-users to upload files (e.g., images, documents) directly to your MinIO storage via a temporary, secure link.
  • Integrating with external systems that need to send data/files to your storage without exposing your MinIO credentials.
  • Automating file ingestion pipelines where upload permissions are time-limited and controlled.

Example:
A web application requests a presigned PUT URL from n8n, then provides it to the browser so the user can upload a file directly to MinIO.


Properties

Display Name Type Meaning
Bucket Resource Locator The target MinIO bucket. Can be selected from a list or entered manually by name.
Key String The object key (path/filename) within the bucket where the uploaded file will be saved.

Output

The node outputs a JSON object with the following structure:

{
  "url": "<presigned_put_url>"
}
  • url: The generated presigned PUT URL. Use this URL to upload a file to the specified bucket and key.

Dependencies

  • MinIO server: You must have access to a running MinIO instance.
  • API Credentials: Requires valid MinIO credentials configured in n8n as minioCredentialsApi.
  • n8n Configuration: The node must be properly set up with the correct credentials and network access to the MinIO server.

Troubleshooting

Common issues:

  • Missing credentials:
    Error message: No credentials got returned!
    Resolution: Ensure you have set up MinIO credentials in n8n and selected them in the node.

  • Invalid bucket or key:
    Error message: May receive errors from MinIO if the bucket does not exist or the key is invalid.
    Resolution: Double-check the bucket name and key. Make sure the bucket exists and you have permission to write to it.

  • Network/connectivity errors:
    Error message: Errors related to connecting to MinIO.
    Resolution: Verify that n8n can reach the MinIO server (correct endpoint, port, firewall rules).

  • Operation not supported:
    Error message: The operation "..." is not supported!
    Resolution: Ensure you have selected a supported operation.


Links and References

Discussion