How to Install Teedy on FreeBSD Latest

Teedy is an open-source note-taking app that can be installed on different Linux distributions, macOS, and FreeBSD. This guide will walk you through the steps to install Teedy on FreeBSD Latest using the command line.

Prerequisites

A FreeBSD Latest installation with a non-root user with sudo privileges
Basic knowledge of the command-line interface
A stable internet connection

Install Required Dependencies

Update the package list:
```
sudo pkg update
```

Install the required dependencies:

sudo pkg install -y cmake make pkgconf gcc git litehtml

Install PostgreSQL Database Server

Teedy requires a PostgreSQL database server to run. Follow these steps to install PostgreSQL on your FreeBSD machine.

Update the package list:
```
sudo pkg update
```

Install the PostgreSQL database server:

sudo pkg install -y postgresql13-server

Initialize the database cluster:
```
sudo service postgresql initdb
```
This command creates the database cluster in /var/db/postgres/data13.
Start the PostgreSQL service:
```
sudo service postgresql start
```
Enable the PostgreSQL service to start on boot:
```
sudo sysrc postgresql_enable=yes
```

Create the Teedy Database and User

Switch to the postgres user:
```
sudo su - postgres
```
Create a new user for the Teedy database:
```
createuser --pwprompt teedy
```
When prompted, enter a strong password for the teedy user.
Create a new database for Teedy:
```
createdb -O teedy -E UTF8 teedydb
```
Exit the postgres user shell:
```
exit
```

Install Teedy

Clone the Teedy repository from GitHub:

git clone https://github.com/sismics/docs-teedy.git

Navigate to the Teedy directory:
```
cd docs-teedy/src
```
Compile Teedy using CMake:
```
cmake .
make
```
This will build the Teedy executable in the build directory.
Copy the Teedy executable to the desired installation directory:
```
sudo cp build/teedy /usr/local/bin/
```

Create a configuration file for Teedy:

sudo mkdir -p /usr/local/etc/teedy
sudo cp config.sample.json /usr/local/etc/teedy/config.json

Edit the configuration file to specify the database connection information:

sudo nano /usr/local/etc/teedy/config.json

{
  "database": {
    "host": "localhost",
    "port": 5432,
    "user": "teedy",
    "password": "password",
    "database": "teedydb"
  }
}

Replace password with the password you set for the teedy user during the database setup.

Create a systemd service file for Teedy:

sudo nano /usr/local/etc/systemd/system/teedy.service

[Unit]
Description=Teedy Server
After=postgresql.service

[Service]
Type=simple
ExecStart=/usr/local/bin/teedy -c /usr/local/etc/teedy/config.json
User=nobody
Group=www
Restart=always

[Install]
WantedBy=multi-user.target

Reload the systemd daemon:
```
sudo systemctl daemon-reload
```
Enable and start the Teedy service:
```
sudo systemctl enable --now teedy
```
Verify that the Teedy service is running:
```
sudo systemctl status teedy
```

Congratulations! You have successfully installed Teedy on FreeBSD Latest. You can now access the Teedy web interface by navigating to http://your-server-ip:8080 in your web browser.