---
title: Setup
description: Setting up the Integration
previous: /integration
previousTitle: Installation
next: /integration/entities
nextTitle: Features
---

To configure the integration, you'll need your Diagral credentials - the same ones used for the Diagral eOne mobile application.
The `Diagral` integration communicates with the Diagral Cloud.

<Warning>
Please be aware that the Diagral alarm system is a security system, and for security reasons, you may want to consider carefully before connecting it to the Home Assistant automation platform.
Neither the developer of this integration nor the [`pydiagral`](https://github.com/mguyard/pydiagral) library can be held responsible for any issues that may arise from using this integration or the [`pydiagral`](https://github.com/mguyard/pydiagral) library.
Users install and use this integration at their own risk and with full understanding of the potential implications.
</Warning>

## Requirements

1. A working Diagral Alarm system
2. A Diagral connectovity box (DIAG56AAX (End of Sales) or a [DIAG59AAX](https://www.diagral.fr/2026/01/19/nouvelle-centrale-dalarme-ip-4g-diagral-diag99agx/) available inside DIAG99AGX)
3. An active Diagral eOne mobile application account
4. Internet connectivity for your Home Assistant

## Required Information

You'll need just a few details to configure the Diagral integration:
- Your Diagral username (email address)
- Your account password
- Your system serial ID (from the DIAG56AAX/DIAG59AAX box)
- The PIN code associated with your username/password

### Finding Your System Serial ID

The serial number is located inside your Diagral box.
To access it, open the box and locate a label with a QR code.
You'll find a 14-character code - this is your box's serial number.

<Image src="https://raw.githubusercontent.com/mguyard/pydiagral/main/docs/how-to-find-diagral-serial.png" alt="Location of System Serial ID"/>

<Info>
For guidance on opening the box, refer to the official DIAG56AAX/DIAG99AGX documentation provided with your device.
</Info>

## Integration Setup in Home Assistant

<Warning>
As [only one simultaneous connection is allowed by the Diagral API](/faq#session-already-opened), before starting the integration setup, make sure you don't have any other active connections such as with the Diagral eOne mobile application.
</Warning>

Start the setup process by clicking the button below:
[![Open your Home Assistant instance and start setting up a new integration.](https://my.home-assistant.io/badges/config_flow_start.svg)](https://my.home-assistant.io/redirect/config_flow_start/?domain=diagral)

The setup process consists of 3 steps:
- Enter your `Serial ID`
- Provide your `Diagral credentials`
- Configure `Options`
<Image src="/images/configflow-step1.png" alt="Step 1 - Serial ID" />
<Image src="/images/configflow-step2.png" alt="Step 2 - Diagral Credentials" />
<Image src="/images/configflow-step3.png" alt="Step 3 - Diagral Options" />

Fill in all fields and click `Submit`.
A success popup will appear where you can select an area for your Diagral alarm.
<Image src="/images/configflow-success.png" />

Click `Finish` to complete the setup! 🎉

<Success>
Please check your Home Assistant logs to ensure there are no errors related to the Diagral Integration.
[![Open your Home Assistant instance and view your Home Assistant logs.](https://my.home-assistant.io/badges/logs.svg)](https://my.home-assistant.io/redirect/logs/?)
</Success>

## Options

You can customize your integration experience through various options.

### Alarm Panel Options

The Alarm Panel options allow you to specify whether a code should be required when using the Alarm Control Panel UI.
You can configure when a code is required:
- Never: No code required for any action
- Disarm Only: Code required only for disarm actions
- Always: Code required for both arm and disarm actions

<Image src="/images/alarm-control-panel.png" alt="Alarm Control Panel" />

<Info>
Keep in mind, if you switch to `Never` the code will be also automatically removed.
</Info>