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.

Tip

If you are not comfortable with Unix-like systems or prefer a more automated way to deploy Hollo, you can use Railway to deploy Hollo with just a few clicks.

Prerequisites

Before you start, make sure you have the following software installed on your server:

• Git
• Bun
• PostgreSQL
• Redis
• L7 load balancer (e.g., nginx, Caddy)
• A domain name pointing to your server

Installation

Note

Hollo currently doesn’t have a stable release. You can check out the latest code from the main branch on GitHub.

1. Check out Hollo’s latest code from GitHub:

   git clone https://github.com/dahlia/hollo.git
   cd hollo/

2. Install the dependencies using Bun:

   bun install

3. Create a PostgreSQL user and database for Hollo:

   createuser --createdb --pwprompt hollo
   createdb --username=hollo --encoding=utf8 --template=postgres hollo

4. 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:

bun prod

Upgrading Hollo

To upgrade Hollo, just pull the latest code from GitHub and reinstall the dependencies:

1. Pull the latest code from GitHub:

   git pull

2. Reinstall the dependencies:

   bun install

3. Restart the server:

   bun prod