How to install Castopod on FreeBSD

Castopod is a self-hosted podcast platform that allows you to create and manage podcasts. Follow these steps to install Castopod on FreeBSD.

Prerequisites

  1. A FreeBSD server or virtual machine with root access and network connectivity
  2. PostgreSQL database

Step 1: Install dependencies

The first step is to make sure all necessary dependencies are installed.

sudo pkg install -y pkgconf php74-curl php74-dom php74-pecl-redis php74-pgsql php74-xml php74-zip php74-zlib php74-json php74-mbstring php74-gd nginx

Step 2: Download Castopod

You can download the latest version of Castopod from their official website or use the following command to download via the terminal.

sudo cd /usr/local/www/
sudo git clone https://github.com/Castopod/Castopod.git castopod

Step 3: Setup a database

Create a new PostgreSQL database for Castopod.

sudo su - postgres
$ psql
# CREATE USER castopod WITH PASSWORD 'castopod';
# CREATE DATABASE castopod;
# GRANT ALL PRIVILEGES ON DATABASE castopod TO castopod;
# \q
$ exit

Step 4: Configure Castopod

Copy the default configuration file and edit it with your own settings.

sudo cd castopod
sudo cp .env.dist .env
sudo nano .env

Update the database details, mail settings, and other configurations as per your requirements.

Step 5: Install dependencies

Install PHP dependencies via composer.

sudo curl -sS https://getcomposer.org/installer | sudo php -- --install-dir=/usr/local/bin --filename=composer
sudo composer install --no-dev

Step 6: Setup permissions

Set the correct permissions for the Castopod directory.

sudo chown -R www:www /usr/local/www/castopod
sudo chmod -R 775 /usr/local/www/castopod/var

Step 7: Configure Nginx

Create a new Nginx virtual host file for Castopod.

sudo nano /usr/local/etc/nginx/vhosts/castopod.conf

Paste the following code into the file and save it.

server {
    listen 80;
    server_name example.com;
    root /usr/local/www/castopod/public;

    location / {
        try_files $uri /index.php$is_args$args;
    }

    location ~ \.php$ {
        try_files $uri /index.php =404;
        fastcgi_pass unix:/var/run/php74-fpm.sock;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }

    error_page 404 /404.html;
    error_page 500 502 503 504 /50x.html;
    location = /50x.html {
        root /usr/local/www/nginx-dist;
    }
}

Replace example.com with your own domain name. Save and exit the file.

Step 8: Start Nginx and PHP-FPM

Start the Nginx and PHP-FPM services.

sudo sysrc nginx_enable=YES
sudo sysrc php_fpm_enable=YES
sudo service nginx start
sudo service php-fpm start

Step 9: Access Castopod

Open your web browser and go to http://example.com (replace example.com with your own domain name). Castopod should now be installed and ready to use.

Congratulations, you have successfully installed Castopod on FreeBSD!