Buckets

A bucket is cloud storage you own and register with Miru as a destination for uploads. Devices upload data straight into it — your data never passes through Miru’s infrastructure.

​

Properties

​

View a bucket

To view a bucket, navigate to the Buckets page and click the bucket. Its details show the provider, its connection details (region, Role ARN and External ID for AWS; service account for GCS), and when and by whom it was created.

​

Connect a bucket

To connect a bucket, follow the GCS or AWS S3 guide.

​

Verification

When you connect a bucket or change its Role ARN, Miru checks its access before saving:

• It uploads an empty object under .miru/probe/, then tries to delete it. With the write-only access the connect guides grant, the object stays in the bucket.
• For AWS buckets, it also confirms your role can’t be assumed without the external ID.

If a check fails, the bucket isn’t saved.

​

Edit a bucket

Only an AWS bucket’s Role ARN can be edited; GCS buckets have nothing to edit. To upload to a different bucket, connect a new one. To edit a bucket, click the ellipses (…) on the bucket and select Edit. A dialog will appear. Update the Role ARN and click Save.

​

Delete a bucket

Deleting a bucket is only possible if there are no file rules associated with the bucket, the backup settings don’t point at it, and no backup has run to it. Otherwise, you must archive the bucket instead, or first change where backups go. To delete a bucket, click the ellipses (…) on the bucket and select Delete. A confirmation dialog will appear. Click Delete to confirm.

​

Archive a bucket

Archiving a bucket prevents any data uploads from being written to the bucket. However, it does not delete the bucket itself, and can be unarchived at any time. A bucket the backup settings point at can’t be archived. Turn off backups or change where they go first. To archive a bucket, click the ellipses (…) on the bucket and select Archive. A confirmation dialog will appear. Click Archive to confirm.