Storage

Officially supported storages:

Provider prices and limits change. Estimate both stored data and delivery traffic for your expected usage, then check the provider’s current pricing and region-specific terms before you configure storage.

How to add Wasabi?

1. Create a bucket. You can set any name or choose any region. enabling Bucket Versioning or Bucket logging is not necessary. Docs
2. Enable public access to your bucket. Docs
   
3. Create a new root access key. Copy the Access Key & Secret Key. Docs
4. Go to RKHM's `Admin -> Setting -> Files -> Storage Servers` and click on `+ New Item`
5. Enter any name, choose Wasabi from `Type` option. Enter required information and click on `create`
6. Go to RKHM's `Admin -> Setting -> Files -> Storage Setting` and set your new storage as default storage for ALL files or set it for whatever you like

How to add Bunny?

1. Create a storage zone ( Bunny dashboard -> Storage ->  + Add Storage Zone ). Enter any name. Select `Standard` as Storage tier, you don't need SSD for multimedia storage. Select a region, closest to your users' location. Geo Replication is not necessary
2. You are redirected to a new page, Copy your username & password in FTP & API Access page
3. Create a pull zone ( Bunny dashboard -> CDN -> + Add Pull Zone ). Enter any name. Select `Storage Zone` as Origin Type and select your Storage zone that you just created. Select `Standard tier` for Choose tier option - unless you have high volume traffic - and choose the location closest to your users' location in Pricing Zones and create the pull zone
4. You are redirected to a new page. Copy your hostname from Linked Hostnames. For example: media.b-cdn.net
5. If you wish to store HLS-encrypted on Bunny, you should visit your pull-zone, go to "Headers" setting page. Enable "Add CORS headers" and also append m3u8 and ts to "Extension list"
6. Go to RKHM's `Admin -> Setting -> Files -> Storage Servers` and click on `+ New Item`
   
7. Enter any name, choose Bunny from `Type` option. Enter required information and click on `create`
   
8. Go to RKHM's `Admin -> Setting -> Files -> Storage Setting` and set your new storage as default storage for ALL files or set it for whatever you like
   

How to add Storj?

1. Create a new project. Select on Continue with web. Click on Generate passphrase. Save your passphrase and click on continue
2. In your project page, go to Buckets page and create a new bucket. You can enter any name
3. Go to Access page and click on Create S3 Credentials. Enter any name, select S3 Credentials only, give all permissions and continue until your S3 credentials are presented too you.  Copy Access key, Secret key & Endpoint
4. Go back to Buckets page. Find your bucket. Click on 3-dots. Click on Share bucket. Copy your bucket URL
5. Go to RKHM's `Admin -> Setting -> Files -> Storage Servers` and click on `+ New Item`
6. Enter any name, choose Storj from `Type` option. Enter required information and click on `create` 
   
7. Go to RKHM's `Admin -> Setting -> Files -> Storage Setting` and set your new storage as default storage for ALL files or set it for whatever you like
   

How to add Backblaze?

1. Click on Create a bucket in your Backblaze dashboard. Enter any name. Select Public for Files in Bucket are: and disable Object Lock
2. After you bucket is created, find it in Buckets page, find and copy Endpoint then click on CORS Rules. In pop-up, either enter your website address or select Share everything in this bucket with every origin and update rules
3. Go to Application Keys page and click on Add a New Application Key. Enter any name and click on Create new key. Copy keyID, keyName and applicationKey
4. Go to RKHM's `Admin -> Setting -> Files -> Storage Servers` and click on `+ New Item`
   
5. Enter any name, choose Backblaze from `Type` option. Enter required information and click on `create`
   
6. Go to RKHM's `Admin -> Setting -> Files -> Storage Setting` and set your new storage as default storage for ALL files or set it for whatever you like
   

How to add Cloudflare R2?

1. Create an R2 bucket and an R2 API token with object read/write/delete permissions. Save its Access Key ID and Secret Access Key, and find your Cloudflare account ID. R2 credentials guide.
2. In the bucket Settings, connect a custom domain for production public delivery. The r2.dev Public Bucket URL can be used for testing, but is rate limited. Copy the public URL from that screen. The S3 API endpoint ending in r2.cloudflarestorage.com is for authenticated API requests and is not the public delivery URL. Public bucket guide.
3. In RKHM Admin → Setting → Files → Storage Server, create a Cloudflare storage. Enter bucket, keys, account ID, optional jurisdiction, and the public URL in the Public Bucket URL field. RKHM builds the API endpoint from the account ID.
4. Use Test to upload a sample object and open its returned URL. Then set the storage as default under Storage Setting if desired.

How to add CDN77?

1. Create a CDN77 Object Storage bucket and save the bucket name, storage cluster (EU-1, US-1, or EU-3), Access Key, and Secret Key. CDN77 setup guide.
2. Link the bucket to a CDN Resource, then copy the CDN URL from that Resource’s details. This delivery URL is different from the S3 API endpoint. RKHM derives the S3 endpoint from the selected storage cluster. CDN connection guide.
3. In RKHM Admin → Setting → Files → Storage Server, create a CDN77 storage. Select the storage cluster, enter bucket and keys, and put the CDN URL in CDN Resource delivery URL. Do not enter the bucket’s S3 endpoint as the delivery URL.
4. Use Test, open the returned CDN URL, and then select the storage under Storage Setting if desired.

How to add DigitalOcean?

1. Create a Space, choose its region, and create a Spaces access key. Spaces access guide.
2. In Setting → Files → Storage Servers, choose DigitalOcean Spaces. Enter Space name, region code (for example nyc3), access key, and secret. RKHM builds the S3 endpoint. Select Space origin URL or Spaces CDN URL in Delivery address; choose CDN only after enabling it in DigitalOcean. A custom delivery URL can override either choice.
3. Make objects publicly readable through the Space settings or an appropriate policy. Use Test and open its returned URL before making it the default storage.

How to add Hetzner Object?

1. Create a bucket in Falkenstein (fsn1), Nuremberg (nbg1), or Helsinki (hel1), and create an access key. Hetzner overview.
2. In Setting → Files → Storage Servers, choose Hetzner Object Storage. Enter the bucket and keys and select its location. RKHM builds the S3 endpoint and default public object URL. A custom delivery URL is optional.
3. Configure public read access for files you intend to serve, then use Test and open its returned URL.

How to add Oracle Cloud?

1. Create an Object Storage bucket, find your namespace and region identifier, and create a Customer Secret Key for S3-compatible access. OCI S3 compatibility guide.
2. In Setting → Files → Storage Servers, choose Oracle Cloud Object Storage. Enter bucket, namespace, region, access ID, and secret. RKHM builds the S3 compatibility endpoint. Its default delivery URL uses the native OCI Object Storage path; you may enter a custom delivery URL instead.
3. Set the bucket to public read if its files should be reachable without credentials. Use Test and open its returned URL.

How to add Azure Blob?

1. Create a storage account and container. Copy an account key from Access keys. This integration uses the account key for Blob REST upload, check, and delete. Shared Key guide. Shared Key authorization must be enabled on the storage account; this adapter supports files up to Azure’s 5,000 MiB single Put Blob limit.
2. In Setting → Files → Storage Servers, choose Azure Blob Storage. Enter account name, container name, and the base64 account key. RKHM builds the Blob endpoint and default object URL. A custom CDN delivery URL is optional.
3. If RKHM must return publicly readable URLs, allow anonymous blob access on the account and set the container access level to Blob, or use a delivery service that exposes the files. Azure public access guide. Use Test and open its returned URL.

How to add Google Cloud?

1. Create a Cloud Storage bucket and an HMAC key for a service account. RKHM uses the Cloud Storage XML API through its S3 interoperability endpoint. GCS interoperability guide.
2. In Setting → Files → Storage Servers, choose Google Cloud Storage. Enter bucket name, HMAC access ID, and HMAC secret. RKHM uses the fixed storage.googleapis.com endpoint and builds the default public object URL; a custom delivery URL is optional.
3. Grant public object read access to the bucket if RKHM should return anonymous URLs. Use Test and open its returned URL.

How to add MinIO?

• Install MinIO on your server/cloud ( Many guides available online, unrelated to RKHM )
• Visit MinIO Console ( Usually http://your-server-ip:9001 )
• Create a new user and give it readWrite access

• Edit newly created user. Select Service accounts
• Click on Create Access Key and create credentials for user ( Don't forget to copy them! )

• Now create a new bucket ( copy the name )

1. Edit newly created bucket
2. Select Anonymous Access and click on Add Access Rule

• Enter / as Prefix
• Select readonly as Access
• Click on Save

1. Go to RKHM's `Admin -> Setting -> Files -> Storage Server` and click on `+ New Item`
2. Enter any name, choose MinIO from `Type` option. Enter required information and click on `create`
3. Your MinIO URL probably is http://your-server.com:9000
4. Go to RKHM's `Admin -> Setting -> Files -> Storage Setting` and set your new storage as default storage for ALL files or set it for whatever you like