Skip to content

Instantly share code, notes, and snippets.

@johannrichard
Last active June 29, 2023 09:54
Show Gist options
  • Save johannrichard/0ad0de1feb6adb9eb61a to your computer and use it in GitHub Desktop.
Save johannrichard/0ad0de1feb6adb9eb61a to your computer and use it in GitHub Desktop.
Systemd Service for homebridge (http://github.com/nfarina/homebridge)
# Defaults / Configuration options for homebridge
# The following settings tells homebridge where to find the config.json file and where to persist the data (i.e. pairing and others)
HOMEBRIDGE_OPTS=-U /var/lib/homebridge
# If you uncomment the following line, homebridge will log more
# You can display this via systemd's journalctl: journalctl -f -u homebridge
# DEBUG=*
[Unit]
Description=Node.js HomeKit Server
After=syslog.target network-online.target
[Service]
Type=simple
User=homebridge
EnvironmentFile=/etc/default/homebridge
# Adapt this to your specific setup (could be /usr/bin/homebridge)
# See comments below for more information
ExecStart=/usr/local/bin/homebridge $HOMEBRIDGE_OPTS
Restart=on-failure
RestartSec=10
KillMode=process
[Install]
WantedBy=multi-user.target
@Patrykos9114
Copy link

Patrykos9114 commented Jul 21, 2018

Any solution ? The homebridge server worked well for a few days, today it stopped.

zrzut ekranu 2018-07-21 o 20 16 52

zrzut ekranu 2018-07-21 o 20 17 42

@mentaluproar
Copy link

I'm sorry. I don't understand where I'm messing up here. I get the following error.

sean@rock64:/etc/systemd/system$ systemctl status homebridge
● homebridge.service - Node.js HomeKit Server
Loaded: loaded (/etc/systemd/system/homebridge.service; enabled; vendor preset: enabled)
Active: activating (auto-restart) (Result: resources) since Tue 2018-08-07 05:29:14 UTC; 3s ago

Aug 07 05:29:14 rock64 systemd[1]: homebridge.service: Failed to run 'start' task: No such file or directory
Aug 07 05:29:14 rock64 systemd[1]: Failed to start Node.js HomeKit Server.
Aug 07 05:29:14 rock64 systemd[1]: homebridge.service: Unit entered failed state.
Aug 07 05:29:14 rock64 systemd[1]: homebridge.service: Failed with result 'resources'.

@jocamero
Copy link

Thanks so much for this tutorial, it was really helpful! The only thing I would like to add / clarify to the original post in the Configuration section are the following commands:

mkdir /var/lib/homebridge (this creates the required directory that stores the config.json file in the modified located)

sudo chown -R homebridge:homebridge /var/lib/homebridge
sudo chmod 777 -R /var/lib/homebridge
(these commands set the permissions on the newly created folder, so that the homebridge user has the appropriate permissions)

@FrothyDog
Copy link

The homebridge-harmonyhub plugin would not install globally so instead I tried installing node using nvm. It worked great. I was able to install homebridge and all plugins without needing root. I can invoke homebridge just fine from the command line, but when starting as a service it fails with this message -

homebridge[5072]: /usr/bin/env: ‘node’: No such file or directory

I have no idea where to begin with this one.

@TubadoG
Copy link

TubadoG commented Nov 11, 2018

One of the plugins I'm attempting to use (Homebridge-dash) requires that Homebridge be run using evaluated permissions. I've setup the systemd service and all has worked fine for several months - but my question is this: does the systemctl start homebridge command run at elevated permissions, and if not, how can I add sudo to the the restart?

@fuerst
Copy link

fuerst commented Nov 18, 2018

Note for systemd users: Your start service needs to start the NetworkManager-wait-online.service before being able to wait after it is finished:

[Unit]
Description=Node.js HomeKit Server 
Wants=network-online.target
After=syslog.target network-online.target

See https://unix.stackexchange.com/a/126146 for details.

@patrickxcarinehome
Copy link

I had the same problem as several have described, with "homebridge.service: Main process exited, code=exited, status=1/FAILURE". In my case, the issue was related to the homebridge-nukiio plugin not being able to start up without root access for some reason. I'm not sure why that was, especially since I had chowned and chmoded everything to homebridge with 0777 to be sure (the service itself, the /var/default/homebridge environment, /var/lib/homebridge/*, including persist and config.json - I do mean EVERYTHING), but, even though I know it's not best practice, once I switched to User: root in /var/systemd/system/homebridge.service everything started working. (User: pi didn't work either, in case anybody is wondering; removing nukiio from the platforms in config.json and running with User: homebridge worked just fine).

I have a same problem with nukiio on homebridge reboot !!!
How do we repair it ?
Thanks :-)

@kerttll
Copy link

kerttll commented Feb 27, 2019

After trying million ways to get it work i finally, hopefully, managed to get rid of the "homebridge.service: Main process exited, code=exited, status=1/FAILURE". In the Homebridge defaults (etc/defaults/homebridge) you have to put HOMEBRIDGE_OPTS= the real config.json file folder. For me it was: HOMEBRIDGE_OPTS=-I -U /home/pi/.homebridge. Hope it helps!

@nisutec
Copy link

nisutec commented Jul 3, 2019

I have a problem. The Homebridge can't find the config.json.
My /etc/systemd/system/homebridge.service is:

[Unit]
Description=Node.js HomeKit Server 
After=syslog.target network-online.target

[Service]
Type=simple
User=homebridge
EnvironmentFile=/etc/default/homebridge
# Adapt this to your specific setup (could be /usr/bin/homebridge)
# See comments below for more information
ExecStart=/usr/local/bin/homebridge $HOMEBRIDGE_OPTS
Restart=on-failure
RestartSec=10
KillMode=process

[Install]
WantedBy=multi-user.target

The homebridge file is the same file with no changes.
When i try to run homebridge manually it works.

pi@piHomebridge:~ $ sudo su - homebridge
No directory, logging in with HOME=/
$ bash
homebridge@piHomebridge:/$ /usr/bin/homebridge -U /var/lib/homebridge

Output:

[7/3/2019, 20:48:38] Loaded config.json with 1 accessories and 0 platforms.
[7/3/2019, 20:48:38] ---
[7/3/2019, 20:48:38] Loaded plugin: homebridge-wol
[7/3/2019, 20:48:38] Registering accessory 'homebridge-wol.NetworkDevice'
[7/3/2019, 20:48:38] ---
[7/3/2019, 20:48:38] Loading 0 platforms...
[7/3/2019, 20:48:38] Loading 1 accessories...

The directory is okey

homebridge@piHomebridge:/$ ls -l /var/lib/homebridge/
total 12
drwxrwxrwx 2 homebridge homebridge 4096 Jul  3 18:29 accessories
-rwxrwxrwx 1 homebridge homebridge  460 Jul  3 20:01 config.json
drwxrwxrwx 2 homebridge homebridge 4096 Jul  3 20:02 persist

But when i try to start the homebridge deamon with sudo systemctl start homebridge it not starts correctly.
journalctl -u homebridge shows:

...
[7/3/2019, 18:36:58] config.json (/var/lib/homebridge/config.json) not found.
...

How i can fix this problem ?

@omencat
Copy link

omencat commented Aug 16, 2019

If you already added your homebridge/accessories in the Home App before migrating to systemd, then you will need to copy the files from your ~/.homebridge/persist to /var/lib/homebridge/persist. This is what fixed the issue of the Home app not responding to any accessories or the homebridge hub.

@0evmc
Copy link

0evmc commented Oct 28, 2019

@codenko & @kevince52

Verify that the path is accurate -- I had to add word "local" to the path in homebridge.service file.
ExecStart=/usr/local/bin/homebridge $HOMEBRIDGE_OPTS

That ended up being my issue as well. I could manually start my second instance, but the service would not run. I had to change /usr/bin/homebridge to /usr/local/bin/homebridge and everything started working.

@bogdanbradeanu
Copy link

hello,
i followed the new instructions to install homebridge on raspberianOS, but i seem to fail to understand how to fix this error:
systemctl enable homebridge => update-rc.d: error: homebridge Default-Start contains no runlevels, aborting.

Any solutions?

@leperchaun
Copy link

Hello everyone! I want to run Homebridge in insecure mode.
Now from terminal i have to do homebridge -I.

How can I implement it in the bootup script? Thanks :)

I got mine to work by editing the /usr/local/bin/homebridge and instead of using strict, changed to use insecure and it worked just fine

@esgie
Copy link

esgie commented Nov 1, 2020

@kaaspad I too would like to know why the separate homebridge user is necessary, however from my experience it really is. I'd initially set up homebridge with the config.json in /home/pi/.homebridge. After some initial success, homebridge failed to run at boot time. I could still run it directly (just typing "homebridge"), but it failed to start when using systemctl. Looking at the errors, it appeared to be related to not being able to access the persist directory.

Changing to a separate homebridge user and putting the config.json in /var/homebridge (and having that directory owned by and writable by the homebridge user) fixed things.
Except of system services, systemd supports something that is called „user services” aswell.
The .service file (in the very same format as for system service, execpt the „user” property which should be omitted) are to be placed in /lib/systemd/user
Then, the service can be controlled (started, enabled, etc.) via sysctl by a regular user like pi.
Creating separate users have some sense when the service must be run with root privileges for some reason (like opening listen socket on port below 1024), amd usually after completing root actions the ownership of the running service is dropped to that (unprivileged) user.
In case of homebridge, there is absolutely NO need of running it with root privileges UNTIL you do not use plugins which require some elevated privileges. That is why running homebridge as a system service in most cases is not really required, in fact it creates some additional security risk.
I’d stick with user service (see first paragraph) or run homebridge via node’s pm2 manager which is more than comfortable.

@VMicha
Copy link

VMicha commented Nov 7, 2020

Note for systemd users: Your start service needs to start the NetworkManager-wait-online.service before being able to wait after it is finished:

[Unit]
Description=Node.js HomeKit Server 
Wants=network-online.target
After=syslog.target network-online.target

See https://unix.stackexchange.com/a/126146 for details.

This was the solution for me - thank you fuerst!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment