2026.3.0
Home ▸ Integrations ▸

IDrive e2

The IDrive e2 integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] allows you to use an IDrive e2 bucket with Home Assistant Backups.

Prerequisites

Before configuring this integration, you need to prepare your IDrive e2 account. This includes creating a bucket to store your backups and an access key with permissions to that bucket.

Create a new IDrive e2 bucket
  1. Log in to the IDrive e2 Management Console.
  2. Follow the steps on creating a bucket in the iDrive documentation.
  3. When prompted to define a bucket name, make sure it is unique: Name (for example, home-assistant-backups-123456).
  4. When adjusting the settings:
    • Files in bucket are private: Enabled by default. It is recommended to leave it enabled.
    • Versioning (optional): Lets you recover backups after Home Assistant deletes them, but it can increase storage costs. Disable this to allow permanent deletion based on retention settings.
  5. Make a note of the bucket name and region. You’ll need it later.
Create an access key

To create an access key that has access to the bucket:

  1. Log in to the IDrive e2 Management Console.
  2. Follow the steps on creating an access key in the iDrive documentation.
  3. When prompted to define a name, make it descriptive (for example, home-assistant-backup).
  4. When adjusting the settings:
    • Access key expiry: Disabled by default. It is recommended to leave it disabled.
    • Access permission: Read and write (default).
      • Allow deletion of objects: Enabled by default. It is recommended to leave it enabled.
      • Allow bucket deletion: Disable this option (unchecked).
  5. Assign the access key to the bucket you created earlier.
  6. Make a note of the Access key id and Secret access key. You’ll need them when configuring the integration in Home Assistant.

Note

  • Avoid using credentials that have more permissions than is necessary.

  • By limiting credentials to a specific bucket, you reduce risk and help keep your IDrive e2 account secure.

Configuration

To add the IDrive e2 service to your Home Assistant instance, use this My button:

Manual configuration steps

If the above My button doesn’t work, you can also perform the following steps manually:

  • Browse to your Home Assistant instance.

  • Go to Settings > Devices & services.

  • In the bottom right corner, select the Add Integration button.

  • From the list, select IDrive e2.

  • Follow the instructions on screen to complete the setup.

Access key id

The access key ID for your IDrive e2 account.

Secret access key

The secret access key for your IDrive e2 account.

Bucket name

IDrive e2 bucket name to store the backups. Bucket must already exist and be writable by the provided credentials.

Removing the integration

This integration follows standard integration removal. No extra steps are required.

To remove an integration instance from Home Assistant

  1. Go to Settings > Devices & services and select the integration card.
  2. From the list of devices, select the integration instance you want to remove.
  3. Next to the entry, select the three dots menu. Then, select Delete.