Manual installation
Hollo can be installed manually on your server. This guide will walk you through the process of setting up Hollo on your server. It assumes you have some experience with running web applications and are comfortable with the command line.
Prerequisites
Before you start, make sure you have the following software installed on your server:
- Git
- Node.js
- pnpm
- ffmpeg
- PostgreSQL
- L7 load balancer (e.g., nginx, Caddy)
- A domain name pointing to your server
Installation
-
Check out Hollo’s latest code from GitHub:
git clone -b stable https://github.com/fedify-dev/hollo.gitcd hollo/ -
Install the dependencies using pnpm:
pnpm install -
Create a PostgreSQL user and database for Hollo:
createuser --createdb --pwprompt hollocreatedb --username=hollo --encoding=utf8 --template=postgres hollo -
Create a configuration file for Hollo:
cp .env.sample .env
Configuration
Once you’ve installed Hollo, you need to configure it. Open the .env file you created earlier and adjust the environment variables.
See the Environment variables chapter for details on how to configure Hollo.
Starting the server
To start the server, run the following command:
pnpm run prod
Upgrading Hollo
To upgrade Hollo, just pull the latest code from GitHub and reinstall the dependencies:
-
Pull the latest code from GitHub:
git pull -
Reinstall the dependencies:
pnpm install -
Restart the server:
pnpm run prod