Skip to content

Configuration

Jump to bottom
Jezza edited this page Sep 19, 2025 · 2 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

General Settings

  • Polling interval: The interval in seconds to query the Petkit API (default: 60)
  • Smart polling: Enables adaptive scanning to reduce polling interval when device is active or an event is detected (default: enabled)

Advanced Media Configuration

⚠️ IMPORTANT

It's recommended to use external storage for storing media files. Since the device can generate many media files, this can quickly fill your Home Assistant storage. Especially if you have the "Retrieve videos" option enabled.

ℹ️ You can mount external storage in Home Assistant via: Settings > System > Storage > Add network storage. Once mounted, use the path /your_storage_name to store media files on that storage.

⚠️ Important: Don't use the full path shown in the "Remote share path" field, it won't work. Also, keep in mind that paths are case-sensitive.

Available Media Options

  • Media path: The path for storing media files (default: /media)
  • Media refresh interval: The interval in minutes to refresh the media list (default: 5)
  • Retrieve images: Enables image retrieval for feeders/litters with camera (default: enabled)
  • Retrieve videos: Enables video retrieval for feeders/litters with camera (default: disabled)
  • Event type for download: The event type to download media (default: Eat, Feed, Toileting)
  • Delete media after (days): The number of days to keep media files (default: 3). Set to 0 to keep all files.

Advanced Bluetooth Relay Configuration

  • 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)

Configuration Troubleshooting

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

Clone this wiki locally