Skip to content

Configuration

Jezza edited this page Apr 29, 2026 · 7 revisions

Configuration

Basic Configuration

Basic configuration is simple, just follow the instructions when setting up the integration. You only need to enter your Petkit account credentials.

Simultaneous Use with Official App

⚠️ IMPORTANT

To use both the official Petkit app AND Home Assistant simultaneously, you need two accounts:

  • Use your PRIMARY account with the official Petkit app to maintain full control over device management
  • Use your SECONDARY account for the Home Assistant integration

Add the secondary account to your primary account's family in the Petkit app.

How to Create a Family and Add a Member

  1. Open the Petkit app and log in with your primary account
  2. At the top of the screen, tap Family Management, then select Create Family and follow the instructions
  3. Once the family is created, tap the Add Family Member button
  4. Add your secondary Petkit account
  5. Finally, log into the Home Assistant integration using your secondary account

Advanced Configuration

Media options

Check detailled information here : Media Management - Photo and video management

Bluetooth options

  • Enable bluetooth relay: Enables bluetooth relay for fountains with bluetooth, you need a relay device (default: enabled)
  • Bluetooth refresh interval: The interval in minutes to scan bluetooth devices (default: 30)

Notifications options

In this section, you can enable or disable persistent notifications in Home Assistant that you want to receive from your Petkit devices.

By default, all notifications from devices are enabled.

Configuration Troubleshooting

If you encounter issues during configuration, check the Troubleshooting page or join our Discord for help.

Clone this wiki locally