How to Configure IDrive e2 CDN
This guide follows IDrive e2’s official developer / FAQ steps to enable a region, create a bucket and access key, copy your unique Service URL, then paste them into XFile Ultra.
Sources: Developer guide · Access key FAQs · Region endpoints
Important: Unlike Amazon S3, IDrive e2 gives each user unique region endpoints. Access keys are region-specific. Always use the Service URL from your Dashboard for the same region as the bucket and the key.
---
Where this goes in XFile Ultra
Admin → Servers → Servers management → Add new CDN (or edit an existing CDN)
Provider: IDrive e2
---
What to paste into XFile Ultra
| XFile Ultra field | Copy from IDrive e2 |
|---|---|
| Access key ID | Access Key ID |
| Secret access key | Secret Access Key (shown once) |
| Bucket name | Exact bucket name |
| S3 endpoint URL | Your region endpoint / Service URL with https:// |
| Region | Optional (use the region string IDrive shows if required) |
| Public / custom domain URL | Optional |
---
Step 1 — Enable a region and copy the Service URL
Per IDrive e2 developer guide + access key FAQ:
1. Sign in to your IDrive e2 account in a browser
2. You land on the Dashboard tab
3. Find Enabled regions
4. If the region you want is missing:
- Click Add New Region
- Select a region from the dropdown
- Click Enable
5. Optional: use Check latency for regions to pick a nearby location
6. In Enabled regions, copy the endpoint URL for that region (unique to your account)
Paste into XFile Ultra as https://… (add https:// if the console shows a host only). HTTP is not supported.
Example shape (yours will differ): https://s3.us-west-2.idrivee2.com
---
Step 2 — Create a bucket
Per IDrive e2 developer guide — Buckets:
1. Click the Buckets tab
2. Click Create Bucket
3. In the pop-up:
- Change the region in the dropdown if needed (must match the region from Step 1)
- Enter a bucket name
- Optional: enable Default Encryption (recommended)
- Optional: Object Locking / Versioning only if you need them
4. Click Create Bucket
Copy the exact bucket name.
---
Step 3 — Create an Access Key
Per FAQs about IDrive e2 Access Keys and the developer guide:
1. Sign in to IDrive e2
2. Open the Access Keys tab (FAQ also says Access Key tab)
3. Click Create Access Key
4. Enter a name for the access key
5. Select a region from the enabled regions dropdown — same region as the bucket
6. Set an expiry date and time if the form offers it (or leave as allowed)
7. Select access permission:
- Read and write — required for XFile Ultra uploads
- Not Read only / Upload only for full site use
8. If Read and write: set object/bucket deletion preferences as you prefer
9. Assign buckets — choose your bucket, or leave all buckets (default). All-buckets / broad write access often lets CORS auto-apply
10. Click Create Access Key
11. Copy Access Key ID and Secret Access Key → download/copy and save them
IDrive will not show the secret again. Access key roles cannot be edited — delete and recreate to change permissions.
You can create up to 250 access keys per region (IDrive FAQ).
---
Step 4 — Map values into XFile Ultra
| Field | Value |
|---|---|
| Access key ID | Access Key ID from Step 3 |
| Secret access key | Secret Access Key from Step 3 |
| Bucket name | Bucket from Step 2 |
| S3 endpoint URL | Service URL from Step 1 (https://…) |
| Region | Optional region string if IDrive requires it |
Finish in XFile Ultra
1. Open Admin → Servers → Servers management → Add new CDN (or edit an existing CDN)
2. Choose the matching CDN provider
3. Paste every value from the “What to paste” table
4. Leave Performance mode on unless you want uploads to proxy through your VPS
5. Set the server status to ON when ready
6. Click Test connection
7. Click Save
If Test connection succeeds but says Performance mode requires bucket CORS, open Performance mode requires bucket CORS and paste the rule for your provider.
---
Common problems
Bucket not found / wrong region or endpoint
The bucket name must match exactly. The region (or Contabo / IDrive endpoint, or Cloudflare Account ID) must be the one for that bucket.
Access denied / bad credentials
Wrong Access Key ID or Secret Access Key, or the key cannot read/write that bucket. Create a new key with the right permissions and paste again.
Secret key lost
Almost every provider shows the secret once. You cannot look it up later — create or regenerate a key, update XFile Ultra, and stop using the old key.
Test connection OK, browser upload fails
Usually CORS. Use the Performance mode CORS article, or turn Performance mode off temporarily while you fix it.
Manual CORS (if needed)
In IDrive e2, open the bucket’s CORS settings (Bucket CORS / CORS Configuration) and paste the JSON from Performance mode requires bucket CORS.