InfluxDB v1 Home Assistant Add-on

This add-on provides InfluxDB 1.x, a time series database optimized for high-write-volume metrics, sensor data, and events. It uses the InfluxQL query language and the 1.x HTTP API.

Key features included in this add-on:

• InfluxDB 1.x core: The database engine using the classic database, user, and retention policy model.
• Chronograf: An admin interface for managing users, databases, and retention settings, and for exploring data via the Data Explorer.
• Kapacitor: A streaming analytics and alerting engine.

Note: This is specifically the 1.x series. It is not InfluxDB 2 or 3, which use different APIs and data models.

To send Home Assistant state changes to InfluxDB, follow these steps:

1. Prepare InfluxDB

1. Click OPEN WEB UI in the add-on.
2. In the left menu, select InfluxDB Admin.
3. Create a database (e.g., homeassistant).
4. Go to the Users tab and create a user (e.g., homeassistant).
5. Grant the user ALL permissions to allow writing to the database.

2. Configure Home Assistant

Add the following to your configuration.yaml file. Replace <yourpassword> with the password created in the step above.

Note: Ensure api_version is set to 1.

influxdb:
  api_version: 1
  host: a0d7b954-influxdb
  port: 8086
  database: homeassistant
  username: homeassistant
  password: <yourpassword>
  max_retries: 3
  default_measurement: state

Full Add-on Backup

Because all databases, Chronograf settings, and Kapacitor data are stored in the add-on's data directory, a standard Home Assistant backup includes everything.

Database-level Backup/Restore

To perform database-level operations from another machine:

1. Ensure port 8088/tcp is enabled in the add-on network settings.
2. Use the influxd backup and influxd restore tools.
3. You can also use the influx CLI to import/export data via the /share folder, which is accessible inside the add-on.

To install the InfluxDB v1 add-on in Home Assistant:

1. Open the add-on via the Home Assistant My button.
2. Click the Install button.
3. Start the "InfluxDB v1" app.
4. Check the add-on logs to verify a successful startup.
5. Click OPEN WEB UI to access the Chronograf admin interface.

You can use the envvars option to pass configuration to InfluxDB using environment variables. Each entry requires a name (must start with INFLUXDB_) and a value (must be a string).

Example: Enabling the InfluxDB UDP listener on port 8089:

envvars:
  - name: INFLUXDB_UDP_0_ENABLED
    value: "true"
  - name: INFLUXDB_UDP_0_BIND_ADDRESS
    value: ":8089"
  - name: INFLUXDB_UDP_0_DATABASE
    value: "udp"

The following ports are exposed by the add-on:

• 8086/tcp: InfluxDB HTTP API (used by Home Assistant, Grafana, etc.).
• 8088/tcp: InfluxDB RPC service (used for influxd backup and influxd restore).
• 8089/udp: InfluxDB UDP listener (disabled by default; enable via envvars).
• 9092/tcp: Kapacitor HTTP API (for managing Kapacitor tasks externally). Warning: Kapacitor has no authentication; only expose this on a trusted network.