Install

Build Hue from a clone of the repository and install it on your server.

Prerequisites

  • The dependencies for your operating system: Python 3.11 and Node.js 22.13 or later.
  • A user to run Hue. Run Hue as a non-root user.

Install Hue

  1. Set the build variables:

    export PYTHON_VER=python3.11
    
  2. Set PREFIX to the directory that will contain the hue directory, then install:

    PREFIX=$HOME make install
    cd $HOME/hue
    

    Hue is installed in $PREFIX/hue. If you do not set PREFIX, it defaults to /usr/local, which usually requires root. To install in a shared location such as /usr/share, run the command with sudo and give the Hue user ownership of the hue directory.

You can install Hue anywhere on your system. Install it in a directory within /usr/share or in the home directory of the user that runs Hue.

Build a tarball

To build a tarball for production, run make prod in the Hue directory:

make prod

The tarball is created in build/release/prod/.

Start Hue

After the installation, start Hue from the installation directory:

build/env/bin/supervisor

The supervisor starts the Hue processes. Open http://<server>:8888/. The first user who logs in becomes the superuser.

Note: Hue uses an embedded SQLite database by default. Configure another database before real use.

Next, configure the server and point it to the external services to query.