This guide provides step-by-step instructions to show you how to install Homebridge on your Android device. Imagine using your old phone as a home server.
Before you get started, make sure you have the following ready:
- A device with Android 7 or higher.
⚠️ For Android 12, 12L and 13+ complete these steps. - A DHCP-enabled network.
Tested devices & components
Device | Android |
---|---|
Samsung Galaxy J7 (j7y17lte) | 7 |
Component | Version |
---|---|
termux | 0.118.0 |
openssl | 1.1.1u |
Python | 3.11.4 |
node | v18.16.0 |
npm | 9.5.1 |
homebridge | @1.6.1 |
homebridge-config-ui-x | @4.50.4 |
You can watch the video of the process here or Read this article here to complete steps manually.
The Termux app, which is going to be installed in the next step, is deprecated on Play Market, Play Store, etc. That is why enabling app installation from Unknown Sources
is required.
- Open
Settings
- Find and click on
Lock screen and security
- Enable
Unknown sources
Screenshots
Settings | Lock screen and security |
---|---|
![]() |
![]() |
- Download the Termux
apk from: https://f-droid.org/repo/com.termux_118.apk - Open
My files
app on your device - Open
Downloads
folder - Open
com.termux_118.apk
file - Tap
Install
button on the right bottom corner - Tap
Done
button
Alternative sources to get Termux ![Termux icon](/assets/termux-icon.png)
from
![Termux icon](/assets/termux-icon.png)
- Open this page and copy command below:
curl https://raw.githubusercontent.com/Orachigami/homebridge-android/main/setup.sh | bash
- Open Termux app
- Wait until it launches
- Tap & Hold your finger on any place until you see a context menu with
COPY PASTE MORE...
buttons - Tap
PASTE
- Tap
Enter
button which should like something like ↩️ or 🔎
Installation process takes approximately 5 minutes.
If everything was installed successfully you will receive:
== Installation successful ==
Execute hb command to start
To test that Homebridge just works execute any of these commands:
Regular start | Start with Accessory Control |
---|---|
hb |
hb -I |
Wait for the message:
[Homebridge UI] Homebridge Config UI X ... is listening on :: port 8581
Which means that you can open your browser, type in the address bar http://<your device ip>:8581 and complete setup.
The Homebridge UI web interface will allow you to install, remove and update plugins, and modify the Homebridge config.json and manage other aspects of your Homebridge service.
Login to the web interface by going to http://<ip address of your device>:8581.
To find the IP address of your server you can run:
ifconfig | awk '/netmask/{print $2}'
Ignore 127.0.0.1 if you don't know what it is.
Are these apk files official? |
---|
No but approved by official Termux repo: It is recommended that you shift to F-Droid or GitHub releases. |