How to Install Schort on OpenBSD

Schort is an open-source URL shortener that lets you easily shorten any URL. In this tutorial, we will guide you through the installation process of Schort on OpenBSD.

Prerequisites

Before proceeding with the installation process, make sure that your system meets the following prerequisites:

  • OpenBSD system with a sudo user
  • Installed Git
  • Installed PostgreSQL

Installation Process

Follow these steps to install Schort on your OpenBSD system:

  1. Clone the Schort repository by running the following command:
sudo git clone https://github.com/sqozz/schort.git
  1. Navigate to the Schort directory by running the following command:
cd schort
  1. Install the required dependencies by running the following command:
sudo pkg_add rust postgresql-server
  1. Initialize a new PostgreSQL database cluster by running the following command:
sudo su - _postgresql -c "/usr/local/bin/initdb -D /var/postgresql/data"
  1. Start the PostgreSQL service by running the following command:
sudo rcctl enable postgresql; sudo rcctl start postgresql
  1. Update the PostgreSQL configuration file by running the following command:
sudo vi /var/postgresql/data/pg_hba.conf

Add the following line at the end of the file:

# Schort
local    schort     schort                          trust

Save and close the file.

  1. Create a new PostgreSQL user and database by running the following commands:
sudo -u _postgresql createuser --interactive
Enter name of role to add: schort
Shall the new role be a superuser? (y/n) y

sudo -u _postgresql createdb -O schort schort
  1. Update the Schort configuration file by running the following command:
sudo cp .env.example .env
sudo vi .env

Update the file with the following values:

DATABASE_URL=postgres://schort@localhost/schort

Save and close the file.

  1. Build and start the Schort server by running the following command:
sudo cargo run
  1. Verify that the Schort server is running by navigating to http://localhost:3000/ in your web browser.

Congratulations! You have successfully installed and set up Schort on your OpenBSD system.