5.9 KiB
title | sidebarDepth |
---|---|
Installation | 3 |
How to install Castopod?
Castopod was thought-out to be easy to install. Whether using dedicated or shared hosting, you can install it on most PHP-MySQL compatible web servers.
::: tip Note
We've released official Docker images for Castopod!
If you prefer using Docker, you may skip this and go straight to the docker documentation for Castopod.
:::
Requirements
- PHP v8.0 or higher
- MySQL version 5.7 or higher or MariaDB version 10.2 or higher
- HTTPS support
PHP v8.0 or higher
PHP version 8.0 or higher is required, with the following extensions installed:
Additionally, make sure that the following extensions are enabled in your PHP:
- json (enabled by default - don't turn it off)
- xml (enabled by default - don't turn it off)
- mysqlnd
MySQL compatible database
We recommend using MariaDB.
::: warning Warning
Castopod only works with supported MySQL 5.7 or higher compatible databases. It will break with the previous MySQL v5.6 for example as its end of life was on February 5, 2021.
:::
You will need the server hostname, database name, username and password to complete the installation process. If you do not have these, please contact your server administrator.
Privileges
User must have at least these privileges on the database for Castopod to work:
CREATE
, ALTER
, DELETE
, EXECUTE
, INDEX
, INSERT
, SELECT
, UPDATE
.
(Optional) FFmpeg v4.1.8 or higher for Video Clips
FFmpeg version 4.1.8 or higher is required if you want to generate Video Clips. The following extensions must be installed:
- FreeType 2 library for gd.
(Optional) Other recommendations
- Redis for better cache performances.
- CDN for static files caching and better performances.
- e-mail gateway for lost passwords.
Install instructions
Pre-requisites
-
Get a Web Server with requirements installed
-
Create a MySQL database for Castopod with a user having access and modification privileges (for more info, see MySQL compatible database).
-
Activate HTTPS on your domain with an SSL certificate.
-
Download and unzip the latest Castopod Package onto the web server if you haven’t already.
- ⚠️ Set the web server document root to the
public/
sub-folder within thecastopod
folder.
- ⚠️ Set the web server document root to the
-
Add cron tasks on your web server for various background processes (replace the paths accordingly):
- For social features to work properly, this task is used to broadcast social activities to your followers on the fediverse:
* * * * * /path/to/php /path/to/castopod/public/index.php scheduled-activities
- For having your episodes be broadcasted on open hubs upon publication using WebSub:
* * * * * /usr/local/bin/php /castopod/public/index.php scheduled-websub-publish
- For Video Clips to be created (see FFmpeg requirements):
* * * * * /path/to/php /path/to/castopod/public/index.php scheduled-video-clips
These tasks run every minute. You may set the frequency depending on your needs: every 5, 10 minutes or more.
(recommended) Install Wizard
- Run the Castopod install script by going to the install wizard page
(
https://your_domain_name.com/cp-install
) in your favorite web browser. - Follow the instructions on your screen.
- Start podcasting!
::: info Note
The install script writes a .env
file in the package root. If you cannot go
through the install wizard, you can
create and update the .env
file manually.
:::
Community packages
If you don't want to bother with installing Castopod manually, you may use one of the packages created and maintained by the open-source community.
Install with YunoHost
YunoHost is a distribution based on Debian GNU/Linux made up of free and open-source software packages. It manages the hardships of self-hosting for you.