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.
  :warning: For Android 12, 12L and 13+ complete these steps.
• A DHCP-enabled network.

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

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](https://github.com/termux/termux-app/blob/master/README.md#google-play-store-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 :leftwards_arrow_with_hook: or 🔎

Installation process takes approximately 5 minutes.

If everything was installed successfully you will receive:

== Installation successful ==
Execute hb command to start

After installation

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\://\: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\://\: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