---
title: "Add a Shelly device in Link’nX: IP address, port and credentials"
description: "Add a Shelly device in Link’nX: IPv4 address, port 80 and admin credentials depending on the Gen1, Gen2 or Gen3 generation, before its KNX mappings."
canonical: https://wiki.can-nx.com/en/guides/link-shelly-device/
language: en
product: Link’nX
audience:
  - administrateur
  - installateur
context: "Link’nX web: Shelly list in the Smart Home category, depending on the project and gateway option"
---

# Add a Shelly device in Link’nX: IP address, port and credentials

Context: Link’nX web: Shelly list in the Smart Home category, depending on the project and gateway option

Declare a Shelly device (relay, cover or dimmer) in Link’nX with its IPv4 address, its port and, if its local access is protected, its credentials. This declaration prepares its [KNX mappings](https://wiki.can-nx.com/en/guides/link-shelly-knx/). It does not create a Shelly Cloud account and offers neither a generation selector nor channel discovery.

Intended for the installer or administrator of the project and the gateway, when Shelly is available in the options of your context.

## Before you start

- Note the device’s IPv4 address and port, and its authorized credentials if local access is protected.
- Have the model, generation, mode and available channels confirmed if they are unknown. Link’nX then offers the same rows for every device: yours does not necessarily have all the corresponding relays, covers or dimmers.
- Have the exact support of the model and firmware, the Shelly network settings, mode activation and calibration confirmed for the installation.
- For a **Gen1** cover or dimmer, have the suitable procedure validated by support before relying on the KNX commands and feedback.

## Choose the credentials for the generation

| Device | **Username** | **Password** |
| --- | --- | --- |
| **Gen2/Gen3** with authentication | **admin** | The one configured for the device |
| **Gen1** with authentication | The one of its local access | The one of its local access |
| Local access without authentication | Empty | Empty |

Leaving the fields empty does not bypass authentication: do so only if the device’s local access allows it.

## Declare the device

1. Select the right project and the right gateway in Link’nX.
2. Open **Smart Home → Shelly**, or search for **Shelly** in the device navigation. On a small screen, first open the navigation.
3. Click **Add**.
4. Fill in **Name**, required, up to 64 characters. Fictitious example: `Fictitious room relay`.
5. Fill in **IP address**, required, in IPv4 format. Fictitious example: `192.0.2.30`. Enter the address of the intended device, without a host name, path or port.
6. Check **Port**, prefilled with **80**: keep it or enter the installation’s port. If in doubt, have the value confirmed rather than clearing the field.
7. Fill in **Username** and **Password** according to the table above. The form accepts these fields empty; the device’s local access decides whether they are required.
8. Click the floppy disk at the bottom right and wait for **Success!**. The device appears in the list with its name, IP and port.

The password is masked; the eye at the end of the field shows or hides it. Never share it in a message or an e-mail, and mask it on any screenshot.

## Check the result

1. On the device’s row, click the **Edit** pencil and review the saved settings.
2. Map a command in the [Shelly gateway table](https://wiki.can-nx.com/en/guides/link-shelly-knx/), send it from the bus and watch the device. This test validates authentication and the hardware’s response: **Success!** only confirms that the settings are saved.

## Edit or delete the device

- With the **Edit** pencil, change only the relevant fields, save with the floppy disk and wait for **Updated!**. Then reopen the declaration to review the values. If you leave a modified form, answer the save prompt.
- The **Delete** trash can in the list asks for confirmation. First check the mappings and automations that use this device; [the automation lists](https://wiki.can-nx.com/en/guides/link-lists/) help you find them. Removing the declaration does not reset the Shelly and does not revoke its local access.

## Troubleshooting

- Floppy disk disabled: check **Name**, the IPv4 format of **IP address** and the numeric format of **Port**.
- Shelly missing from the navigation: check the project, the gateway and the option with [Link’nX navigation](https://wiki.can-nx.com/en/guides/link-navigation/). Access depends on the option available in your installation, not on Shelly appearing in an offer or a catalog.
- **Success!** but no reaction from the device: check the IP, the port and the credentials required by its generation, then follow [the Shelly feedback troubleshooting](https://wiki.can-nx.com/en/guides/link-shelly-feedback/).

## Contact support

If the settings remain unknown or these checks are already done, write to support@can-nx.com with the model, the project and gateway, the symptom and the tests carried out. Never send the password.

French labels: **Maison intelligente → Shelly → Ajouter**, **Nom**, **Adresse IP**, **Port**, **Nom utilisateur**, **Mot de passe**, **Succès !**, **Mis à jour !** and **Éditer**.