Install Homebridge on Android

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.

Prerequisites

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
Samsung Galaxy S9	10
Samsung Galaxy A03 Core (a3core)	11
Samsung Galaxy A22	11
Samsung Galaxy A14	13
Realme 7 5G	12

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

Installation

You can watch the video of the process here or complete steps manually.

Configure your device

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.

1. Open Settings
2. Find and click on Lock screen and security
3. Enable Unknown sources

Screenshots

Settings	Lock screen and security

Install Termux app

1. Download the Termux apk from: https://f-droid.org/repo/com.termux_118.apk
2. Open My files app on your device
3. Open Downloads folder
4. Open com.termux_118.apk file
5. Tap Install button on the right bottom corner
6. Tap Done button

Alternative sources to get Termux from

• https://f-droid.org/en/packages/com.termux/
• https://github.com/AndronixApp/termux-releases
• Deprecated: Play Market

Install Homebridge

1. Open this page and copy command below:

curl https://raw.githubusercontent.com/Orachigami/homebridge-android/main/setup.sh | bash

2. Open Termux app
3. Wait until it launches
4. Tap & Hold your finger on any place until you see a context menu with COPY PASTE MORE... buttons
5. Tap PASTE
6. 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 ==
Restart Termux via exit command. Then execute hb-start command to launch Homebridge

After installation

To test that Homebridge just works execute any of these commands:

Regular start	Start with Accessory Control
hb	hb -I
If plugin page doesn't load hb-start	If plugin page doesn't load hb-start -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.

Complete: Login to the Homebridge UI

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.

FAQ

Are these apk files official?
No but approved by official Termux repo: It is recommended that you shift to F-Droid or GitHub releases.

Plugin page doesn't load 500 error
Run hb-start command to launch Homebridge or proot -b ~/stat:/proc/stat hb