Articles in this section

See more

How to install Homey Self-Hosted Server on Proxmox

  • Updated

Homey Self-Hosted Server can be easily installed on Proxmox, an operating system designed to run virtual machines on your own hardware.

Installing Homey Self-Hosted Server

1. Open Proxmox

Open the Proxmox Web UI in your web browser.

2. Open the Shell

In the sidebar on the left, click Datacenter → Proxmox.

Then, on the top right, click >_ Shell.

3. Run the Install Script

Copy & paste the following command:

bash -c "$(curl -fsSL https://proxmox.athom.com/homey-shs.sh)"

Wait for the script to complete. Homey Self-Hosted Server is now installed. You'll see something like this:

[ OK ] Homey SHS deployment complete

Homey Self-Hosted Server (100) is ready.
  Hostname.    : homey-shs
  IP           : 192.168.1.100
  SSH Username : root
  SSH Password : homey
  HTTP Address : http://192.168.1.100:4859

4. Continue on iPhone & Android

Open the Homey app for iOS or Android to add a new Homey, and select Self-Hosted Server.

Updating Homey Self-Hosted Server

There's no need to manually update.

Every time the VM starts, it will automatically fetch the latest Homey Self-Hosted Server software.

Creating a Backup

To create a backup, enter your machine with SSH or another terminal, and copy the files & folders in /root/.homey-shs to a safe location.

To restore a backup, put them back before starting Homey Self-Hosted Server.

Help & Troubleshooting

If you're stuck and need help, head over to the Homey Community Forum.

Related articles