File manager for MinIO and self-hosted S3: connect it to Nubbo

Nubbo connects to any S3-compatible storage that signs with Signature V4, such as MinIO, Ceph or SeaweedFS, on your own server or with another provider. All you need is the endpoint URL, a key and the region. This guide follows the Nubbo wizard step by step, with both paths: automatic or with a key limited to one bucket.

What you get

• Browse the bucket like a drive: folders, views, search, trash, labels and favorites.
• Upload and download files directly between your browser and your server. Files never pass through Nubbo servers.
• Share files and folders with a password, expiry and download limit, receive files into your bucket and create galleries.
• Your keys are stored encrypted with AES-256-GCM and you can disconnect the bucket at any time.

Before you start

You need S3-compatible storage and a Nubbo account. Every bucket you connect counts toward your plan limit: Free allows 2, Personal 5 and Pro has no limit. The endpoint must be a public URL that both Nubbo servers and the browser can reach, and it needs HTTPS, because the browser does not load HTTP content from https://nubbo.app. Nubbo rejects endpoints that point to private or local addresses. If your server has no regions, leave us-east-1.

Choose how to connect

The Nubbo wizard offers two paths. Both end the same way: the bucket connected and ready for uploads from the browser.

Automatic connection

Step 1: create the key in your server

1. Check that your server exposes the S3 API with V4 signatures on a public HTTPS URL, for example https://s3.your-domain.com.
2. Create a key that can create buckets and change their CORS.
3. Note the endpoint URL and the region. If your server has no regions, use us-east-1.

Step 2: connect the bucket in Nubbo

1. In Nubbo, open Buckets and press Connect bucket. Choose Custom S3 / Self-hosted and press Continue.

   

2. Choose Automatic and press Continue.

   

3. In the Your key step, paste the access key, the secret key, the endpoint URL and the region. Press Check key. Nubbo checks that the key works and that it has access to the whole account.

   

4. Pick one of your buckets and press Use this bucket, or select Create a new one, type a name (and pick the region, if it asks) and press Create and prepare. Nubbo adds a CORS rule to the bucket that only allows uploads and downloads from the app, and keeps the rules it already has.

   

5. Review the three checks, change the Name in Nubbo if you like and press Finish. The bucket shows up in Buckets and you can open it in the explorer.

   

If Nubbo cannot add the CORS rule with your key, the wizard takes you to the CORS step. Then follow Add the CORS rule.

Connection with a limited key

Step 1: prepare the bucket and the key in your server

1. Create the bucket on your server (on MinIO, for example, with mc mb).
2. Create a key with read and write permissions on that bucket.
3. Note the endpoint URL and the region.

Step 2: connect the bucket in Nubbo

1. In Buckets, press Connect bucket, choose Custom S3 / Self-hosted and then With a limited key.
2. Paste the access key, the secret key, the endpoint and the region. Press Check key.
3. Type the exact bucket name and press Check access.
4. The wizard moves to the CORS step with the rule you need to add.

Add the CORS rule

The CORS rule lets the browser upload and download files from your bucket on https://nubbo.app. It is the same rule the wizard shows in the CORS step.

How CORS is set up depends on the software:

• MinIO (community edition) does not accept per-bucket CORS: it uses a global setting (MINIO_API_CORS_ALLOW_ORIGIN) that allows any origin by default. If you have not changed it, there is nothing to do: press I added it, check and the check will pass. If you changed it, include https://nubbo.app.
• Ceph and SeaweedFS accept per-bucket CORS through the S3 API. Apply this rule with your usual tool (for example, aws s3api put-bucket-cors with your endpoint), or let Nubbo do it on the automatic path.

[
  {
    "AllowedHeaders": ["*"],
    "AllowedMethods": ["GET", "PUT", "POST", "DELETE", "HEAD"],
    "AllowedOrigins": ["https://nubbo.app"],
    "ExposeHeaders": ["ETag"],
    "MaxAgeSeconds": 3600
  }
]

Once the rule is ready, go back to Nubbo and press I added it, check. On Ceph and SeaweedFS, if your key can change CORS, Try to configure it for me does it for you.

If something goes wrong

What it costs

If you are weighing your own storage against a provider, compare prices and limits in S3 vs R2 vs Spaces vs Wasabi vs Backblaze B2.