FAQ
Does Localkit work without an internet connection?
Yes, after the initial setup your devices communicate entirely on your local network — no cloud access required.
Why do I need my own DNS server?
Localkit redirects Petkit's cloud domains to local IPs. This requires a DNS server like AdGuard Home or Pi-hole that supports custom DNS entries.
Why does each container need its own IP address?
Devices connect on fixed, well-known ports (e.g. 443 for MQTT). Since port rewriting is not possible, each container must be reachable on a dedicated IP to avoid conflicts.
Is Home Assistant supported?
Yes, Localkit integrates with Home Assistant via MQTT. Devices are automatically discovered and appear as native entities.
Is Home Assistant required?
No, Home Assistant is optional. Localkit works fully without it.
What is BYPASS_AUTH?
BYPASS_AUTH automatically logs you in as a specific user, so you don't have to authenticate every time you open the Web UI. Set BYPASS_AUTH=true and BYPASS_AUTH_ID to the user ID you want to be automatically logged in as, should be 1
Devices
Why does the firmware need to be modified?
Petkit secures MQTT connections using their own Certificate Authority (CA). Since a valid certificate signed by their CA cannot be obtained, the firmware must be patched to trust a custom CA — allowing Localkit to act as the MQTT broker.
Can I revert to original Firmware?
Yes, but it's still WIP on the implementation part.
Are Bluetooth devices read-only?
Currently, Bluetooth devices are read-only. sending commands is planned but still WIP.
How do I obtain my Bluetooth Credentials?
Use the following page: https://tool.localkit.io/cloud, login to your Petkit account and you will get an overview of your Bluetooth devices.
How can I add a new device?
Currently, it's required to register new devices via the original Petkit app. Afterwards the device will be added to Localkit automatically.
My device is not supported
Contact me on Discord or GitHub.
On Camera Devices, how to get the Camera Stream?
Internally, Localkit uses Go2RTC to stream the camera stream. Access the UI via :1984
Next Supported Devices?
Petkit Purobot Crystal Duo, Petkit Yumshare Dual-Hopper 2