How to Install Gossa on OpenBSD

Gossa is a self-hosted photo gallery written in Golang. This tutorial will guide you through the installation process of Gossa on OpenBSD.

Prerequisites

  1. A running instance of OpenBSD.
  2. A non-root user with sudo privileges.

Step 1: Install Dependencies

Before installing Gossa, you need to install the required dependencies. Open the terminal and run the following command:

sudo pkg_add go sqlite

The go package will install Golang on your system, and sqlite package will install SQLite3 database.

Step 2: Download Gossa

Go to the Gossa GitHub page and download the latest release:

wget https://github.com/pldubouilh/gossa/releases/latest/download/gossa-x.y.z.tar.gz

Replace x.y.z with the version number of the latest release.

Step 3: Extract Gossa

Extract the downloaded Gossa package using the following command:

tar -xzf gossa-x.y.z.tar.gz

Change the directory to the extracted folder:

cd gossa-x.y.z/

Step 4: Configure Gossa

Create a new configuration file by copying the sample configuration file:

cp config.sample.json config.json

Edit the config.json file and set the following values:

{
  "DatabasePath": "/var/www/gossa/gossa.db",
  "MediaRoot": "/var/www/gossa/static/media",
  "PublicPath": "/media",
  "ListenAddress": "0.0.0.0:8080",
  "ThumbSize": 360,
  "HTTPCacheMaxAge": 2592000
}
  • DatabasePath: The path where the SQLite3 database will be stored.
  • MediaRoot: The path to the folder where your photos will be stored.
  • PublicPath: The public URL path where your photos will be accessible.
  • ListenAddress: The network address and port where Gossa will listen to incoming connections.
  • ThumbSize: The maximum size (in pixels) of the thumbnail images.
  • HTTPCacheMaxAge: The maximum age (in seconds) of the browser cache.

Step 5: Start Gossa

Finally, start Gossa using the following command:

./gossa

Access Gossa in your web browser by navigating to http://<server-ip-address>:8080.

Congratulations! You have successfully installed Gossa on OpenBSD. You can now upload your photos and start organizing them into albums.