Source Installation

First, clone the repository:

git clone https://github.com/gethomepage/homepage.git

If pnpm is not installed, install it:

npm install -g pnpm

Then install dependencies and build the production bundle:

pnpm install
pnpm build

If this is your first time starting, copy the src/skeleton directory to config/ to populate initial example config files.

Finally, run the server:

HOMEPAGE_ALLOWED_HOSTS=gethomepage.dev:1234 pnpm start

When updating homepage versions you will need to re-build the static files i.e. repeat the process above.

See HOMEPAGE_ALLOWED_HOSTS for more information on this environment variable.