Skip to content

Installation

firstof9 edited this page Sep 28, 2026 · 1 revision

Installation

The OpenEVSE integration is distributed as a HACS custom component. HACS is the recommended installation method because it handles updates automatically.


Method 1 — HACS (Recommended)

Prerequisites

  • HACS must already be installed in your Home Assistant instance.

Steps

Option A — One-click badge:

Open your Home Assistant instance and open a repository inside the Home Assistant Community Store.

Option B — Manual HACS add:

  1. Navigate to HACS in the Home Assistant sidebar.
  2. Click the three-dot menu (⋮) in the upper-right corner and select Custom repositories.
  3. Paste the repository URL: https://github.com/firstof9/openevse
  4. Set the category to Integration and click Add.
  5. Find OpenEVSE in the HACS integration list and click Download.
  6. Restart Home Assistant when prompted.

Important

A full Home Assistant restart is required after installation — a simple config reload is not sufficient.


Method 2 — Manual Installation (Advanced)

Warning

Manual installation bypasses HACS update management. You will need to manually repeat these steps for every future release. Use HACS unless you have a specific reason not to.

  1. Open your Home Assistant configuration directory (the folder containing configuration.yaml).
  2. If it does not exist, create a folder called custom_components.
  3. Inside custom_components, create a new folder named openevse.
  4. Download the latest release from the GitHub Releases page.
  5. Extract and copy all files from custom_components/openevse/ into your new openevse folder.
  6. Restart Home Assistant.

Your directory structure should look like:

config/
└── custom_components/
    └── openevse/
        ├── __init__.py
        ├── manifest.json
        ├── sensor.py
        ├── switch.py
        └── ...

After Installation

Once installed and Home Assistant has restarted, proceed to Configuration to set up the integration.

Clone this wiki locally