2022-04-14 15:11:07 +02:00
|
|
|
|
---
|
|
|
|
|
title: Installation
|
|
|
|
|
sidebarDepth: 3
|
|
|
|
|
---
|
|
|
|
|
|
2023-03-16 17:45:41 +01:00
|
|
|
|
# Wie installiere ich Castopod?
|
2022-04-14 15:11:07 +02:00
|
|
|
|
|
2023-05-05 16:28:51 +02:00
|
|
|
|
Castopod ist für eine einfache Installation konzipiert. Ob dediziertes oder
|
|
|
|
|
Shared-Hosting, du kannst es auf den meisten PHP-MySQL-kompatiblen Webservern
|
|
|
|
|
installieren.
|
2022-04-14 15:11:07 +02:00
|
|
|
|
|
2022-08-22 17:56:51 +02:00
|
|
|
|
::: tip Note
|
|
|
|
|
|
2023-05-05 16:28:51 +02:00
|
|
|
|
Wir haben offizielle Docker Images für Castopod veröffentlicht!
|
2022-07-04 15:27:21 +02:00
|
|
|
|
|
2023-05-05 16:28:51 +02:00
|
|
|
|
Wenn du Docker bevorzugst, kannst du die manuelle Anleitung überspringen und
|
|
|
|
|
direkt zur [Docker-Dokumentation](./docker.md) für Castopod gehen.
|
2022-07-04 15:27:21 +02:00
|
|
|
|
|
|
|
|
|
:::
|
|
|
|
|
|
2023-03-16 17:45:41 +01:00
|
|
|
|
## Voraussetzungen
|
2022-04-14 15:11:07 +02:00
|
|
|
|
|
2023-03-16 17:45:41 +01:00
|
|
|
|
- PHP v8.1 oder höher
|
|
|
|
|
- MySQL Version 5.7 oder höher oder MariaDB Version 10.2 oder höher
|
|
|
|
|
- HTTPS-Unterstützung
|
2023-05-05 16:28:51 +02:00
|
|
|
|
- Eine [ntp-synchronisierte Uhr](https://wiki.debian.org/NTP) um die eingehenden
|
|
|
|
|
Anfragen zu überprüfen
|
2022-04-14 15:11:07 +02:00
|
|
|
|
|
2023-03-16 17:45:41 +01:00
|
|
|
|
### PHP v8.1 oder höher
|
2022-04-14 15:11:07 +02:00
|
|
|
|
|
2023-05-05 16:28:51 +02:00
|
|
|
|
PHP Version 8.1 oder höher ist erforderlich, wobei folgende Erweiterungen
|
|
|
|
|
installiert sind:
|
2022-04-14 15:11:07 +02:00
|
|
|
|
|
|
|
|
|
- [intl](https://php.net/manual/en/intl.requirements.php)
|
|
|
|
|
- [libcurl](https://php.net/manual/en/curl.requirements.php)
|
|
|
|
|
- [mbstring](https://php.net/manual/en/mbstring.installation.php)
|
2023-05-05 16:28:51 +02:00
|
|
|
|
- [gd](https://www.php.net/manual/en/image.installation.php) mit **JPEG**,
|
|
|
|
|
**PNG** und **WEBP** Bibliotheken.
|
2022-04-14 15:11:07 +02:00
|
|
|
|
- [exif](https://www.php.net/manual/en/exif.installation.php)
|
|
|
|
|
|
2023-05-05 16:28:51 +02:00
|
|
|
|
Stelle außerdem sicher, dass die folgenden Erweiterungen in deinem PHP aktiviert
|
|
|
|
|
sind:
|
2022-04-14 15:11:07 +02:00
|
|
|
|
|
2023-05-05 16:28:51 +02:00
|
|
|
|
- json (standardmäßig aktiviert - nicht ausschalten)
|
|
|
|
|
- xml (standardmäßig aktiviert - nicht ausschalten)
|
2022-04-14 15:11:07 +02:00
|
|
|
|
- [mysqlnd](https://php.net/manual/en/mysqlnd.install.php)
|
|
|
|
|
|
2023-05-05 16:28:51 +02:00
|
|
|
|
### MySQL kompatible Datenbank
|
2022-04-14 15:11:07 +02:00
|
|
|
|
|
2023-05-05 16:28:51 +02:00
|
|
|
|
> Wir empfehlen [MariaDB](https://mariadb.org).
|
2022-04-14 15:11:07 +02:00
|
|
|
|
|
2022-07-04 15:27:21 +02:00
|
|
|
|
::: warning Warning
|
2022-04-14 15:11:07 +02:00
|
|
|
|
|
2023-05-05 16:28:51 +02:00
|
|
|
|
Castopod funktioniert nur mit unterstützten MySQL 5.7 oder höher kompatiblen
|
|
|
|
|
Datenbanken. Es wird zum Beispiel mit dem vorherigen MySQL v5.6 nicht mehr
|
|
|
|
|
funktionieren, dessen Lebensende am 5. Februar 2021 war.
|
2022-04-14 15:11:07 +02:00
|
|
|
|
|
|
|
|
|
:::
|
|
|
|
|
|
2023-05-05 16:28:51 +02:00
|
|
|
|
Du benötigst den Servernamen, den Datenbanknamen, den Benutzernamen und das
|
|
|
|
|
Passwort, um den Installationsvorgang abzuschließen. Kontaktiere bitte den
|
|
|
|
|
Administrator, falls du keinen Benutzeraccount hast.
|
2022-04-14 15:11:07 +02:00
|
|
|
|
|
2023-05-05 16:28:51 +02:00
|
|
|
|
#### Berechtigungen
|
2022-04-14 15:11:07 +02:00
|
|
|
|
|
2023-05-05 16:28:51 +02:00
|
|
|
|
Benutzer müssen mindestens diese Berechtigungen in der Datenbank haben, damit
|
|
|
|
|
Castopod funktioniert: `CREATE`, `ALTER`, `DELETE`, `EXECUTE`, `INDEX`,
|
|
|
|
|
`INSERT`, `SELECT`, `UPDATE`, `REFERENCES`, `CREATE VIEW`.
|
2022-04-14 15:11:07 +02:00
|
|
|
|
|
2023-05-05 16:28:51 +02:00
|
|
|
|
### (Optional) FFmpeg v4.1.8 oder höher für Videoclips
|
2022-04-14 15:11:07 +02:00
|
|
|
|
|
2023-05-05 16:28:51 +02:00
|
|
|
|
[FFmpeg](https://www.ffmpeg.org/) Version 4.1.8 oder höher ist erforderlich,
|
|
|
|
|
wenn Du Videoclips generieren möchtest. Die folgenden Php-Erweiterungen sind
|
|
|
|
|
nicht installiert: %s:
|
2022-04-14 15:11:07 +02:00
|
|
|
|
|
2023-05-05 16:28:51 +02:00
|
|
|
|
- **FreeType 2** Bibliothek für
|
2022-04-14 15:11:07 +02:00
|
|
|
|
[gd](https://www.php.net/manual/en/image.installation.php).
|
|
|
|
|
|
2023-05-05 16:28:51 +02:00
|
|
|
|
### (Optional) Weitere Empfehlungen
|
2022-04-14 15:11:07 +02:00
|
|
|
|
|
2023-05-05 16:28:51 +02:00
|
|
|
|
- Redis für bessere Cache-Leistungen.
|
|
|
|
|
- CDN für das Caching statischer Dateien und bessere Leistungen.
|
|
|
|
|
- E-Mail Server Anbindung für E-Mails zu verlorenen Passwörtern.
|
2022-04-14 15:11:07 +02:00
|
|
|
|
|
2023-05-05 16:28:51 +02:00
|
|
|
|
## Installationsanleitung
|
2022-04-14 15:11:07 +02:00
|
|
|
|
|
2023-05-05 16:28:51 +02:00
|
|
|
|
### Voraussetzungen
|
2022-04-14 15:11:07 +02:00
|
|
|
|
|
|
|
|
|
0. Get a Web Server with [requirements](#requirements) installed
|
|
|
|
|
1. Create a MySQL database for Castopod with a user having access and
|
|
|
|
|
modification privileges (for more info, see
|
|
|
|
|
[MySQL compatible database](#mysql-compatible-database)).
|
|
|
|
|
2. Activate HTTPS on your domain with an _SSL certificate_.
|
|
|
|
|
3. Download and unzip the latest [Castopod Package](https://castopod.org/) onto
|
|
|
|
|
the web server if you haven’t already.
|
|
|
|
|
- ⚠️ Set the web server document root to the `public/` sub-folder within the
|
|
|
|
|
`castopod` folder.
|
|
|
|
|
4. 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:
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
* * * * * /path/to/php /path/to/castopod/public/index.php scheduled-activities
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
- For having your episodes be broadcasted on open hubs upon publication using
|
|
|
|
|
[WebSub](https://en.wikipedia.org/wiki/WebSub):
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
* * * * * /usr/local/bin/php /castopod/public/index.php scheduled-websub-publish
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
- For Video Clips to be created (see
|
|
|
|
|
[FFmpeg requirements](#ffmpeg-v418-or-higher-for-video-clips)):
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
* * * * * /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
|
|
|
|
|
|
|
|
|
|
1. Run the Castopod install script by going to the install wizard page
|
|
|
|
|
(`https://your_domain_name.com/cp-install`) in your favorite web browser.
|
|
|
|
|
2. Follow the instructions on your screen.
|
|
|
|
|
3. Start podcasting!
|
|
|
|
|
|
|
|
|
|
::: info Note
|
|
|
|
|
|
|
|
|
|
The install script writes a `.env` file in the package root. If you cannot go
|
2022-10-14 18:12:14 +02:00
|
|
|
|
through the install wizard, you can create and edit the `.env` file manually
|
|
|
|
|
based on the `.env.example` file.
|
2022-04-14 15:11:07 +02:00
|
|
|
|
|
|
|
|
|
:::
|
|
|
|
|
|
2022-10-14 18:12:14 +02:00
|
|
|
|
### Email/SMTP setup
|
|
|
|
|
|
|
|
|
|
Email configuration is required for some features to work properly (eg.
|
|
|
|
|
retrieving your forgotten password, sending instructions to premium subscribers,
|
|
|
|
|
…)
|
|
|
|
|
|
|
|
|
|
You may add your email configuration in your instance's `.env` like so:
|
|
|
|
|
|
|
|
|
|
```ini
|
|
|
|
|
# […]
|
|
|
|
|
|
2022-11-04 12:03:24 +01:00
|
|
|
|
# […]
|
|
|
|
|
|
2022-10-14 18:12:14 +02:00
|
|
|
|
email.fromEmail="your_email_address"
|
|
|
|
|
email.SMTPHost="your_smtp_host"
|
|
|
|
|
email.SMTPUser="your_smtp_user"
|
|
|
|
|
email.SMTPPass="your_smtp_password"
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
#### Email config options
|
|
|
|
|
|
|
|
|
|
| Variable name | Type | Default |
|
|
|
|
|
| ---------------- | -------------------- | ------------ |
|
|
|
|
|
| **`fromEmail`** | string | `undefined` |
|
|
|
|
|
| **`fromName`** | string | `"Castopod"` |
|
|
|
|
|
| **`SMTPHost`** | string | `undefined` |
|
|
|
|
|
| **`SMTPUser`** | string | `undefined` |
|
|
|
|
|
| **`SMTPPass`** | string | `undefined` |
|
|
|
|
|
| **`SMTPPort`** | number | `25` |
|
|
|
|
|
| **`SMTPCrypto`** | [`"tls"` or `"ssl"`] | `"tls"` |
|
|
|
|
|
|
2023-04-01 14:38:40 +02:00
|
|
|
|
### Media storage
|
|
|
|
|
|
|
|
|
|
By default, files are saved to the `public/media` folder using the file system.
|
|
|
|
|
If you need to relocate the `media` folder to a different location, you can
|
|
|
|
|
specify it in your `.env` file as shown below:
|
|
|
|
|
|
|
|
|
|
```ini
|
|
|
|
|
# […]
|
2023-03-16 17:45:41 +01:00
|
|
|
|
|
2023-04-01 14:38:40 +02:00
|
|
|
|
media.root="media"
|
|
|
|
|
media.storage="/mnt/storage"
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
In this example, the files will be saved to the /mnt/storage/media folder. Make
|
|
|
|
|
sure to also update your web server configuration to reflect this change.
|
|
|
|
|
|
|
|
|
|
### S3
|
2023-03-16 17:45:41 +01:00
|
|
|
|
|
|
|
|
|
If you prefer storing your media files on an S3 compatible storage, you may
|
|
|
|
|
specify it in your `.env`:
|
|
|
|
|
|
|
|
|
|
```ini
|
|
|
|
|
# […]
|
|
|
|
|
|
|
|
|
|
media.fileManager="s3"
|
|
|
|
|
media.s3.endpoint="your_s3_host"
|
|
|
|
|
media.s3.key="your_s3_key"
|
|
|
|
|
media.s3.secret="your_s3_secret"
|
|
|
|
|
media.s3.region="your_s3_region"
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
#### S3 config options
|
|
|
|
|
|
2023-03-23 13:13:46 +01:00
|
|
|
|
| Variable name | Type | Default |
|
|
|
|
|
| ----------------------- | ------- | ----------- |
|
|
|
|
|
| **`endpoint`** | string | `undefined` |
|
|
|
|
|
| **`key`** | string | `undefined` |
|
|
|
|
|
| **`secret`** | string | `undefined` |
|
|
|
|
|
| **`region`** | string | `undefined` |
|
|
|
|
|
| **`bucket`** | string | `castopod` |
|
|
|
|
|
| **`protocol`** | number | `undefined` |
|
|
|
|
|
| **`pathStyleEndpoint`** | boolean | `false` |
|
|
|
|
|
| **`keyPrefix`** | string | `undefined` |
|
2023-03-16 17:45:41 +01:00
|
|
|
|
|
2022-04-14 15:11:07 +02:00
|
|
|
|
## 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](https://yunohost.org/) 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.
|
|
|
|
|
|
|
|
|
|
<div class="flex flex-wrap items-center gap-4">
|
|
|
|
|
|
|
|
|
|
<a href="https://install-app.yunohost.org/?app=castopod" target="_blank" rel="noopener noreferrer">
|
|
|
|
|
<img src="https://install-app.yunohost.org/install-with-yunohost.svg" alt="Install Castopod with YunoHost" class="align-middle" />
|
|
|
|
|
</a>
|
|
|
|
|
|
|
|
|
|
<a href="https://github.com/YunoHost-Apps/castopod_ynh" target="_blank" rel="noopener noreferrer" class="inline-flex items-center px-4 py-[.3rem] mx-auto font-semibold text-center text-black rounded-md gap-x-1 border-2 border-solid border-[#333] hover:no-underline hover:bg-gray-100"><svg
|
|
|
|
|
xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="1em" height="1em"
|
|
|
|
|
class="text-xl"><path fill="none" d="M0 0h24v24H0z"/><path d="M12 2A10 10 0 0 0 2 12a10 10 0 0 0 6.84 9.49c.5.09.69-.21.69-.48l-.02-1.86c-2.51.46-3.16-.61-3.36-1.18-.11-.28-.6-1.17-1.02-1.4-.35-.2-.85-.66-.02-.67.79-.01 1.35.72 1.54 1.02.9 1.52 2.34 1.1 2.91.83a2.1 2.1 0 0 1 .64-1.34c-2.22-.25-4.55-1.11-4.55-4.94A3.9 3.9 0 0 1 6.68 8.8a3.6 3.6 0 0 1 .1-2.65s.83-.27 2.75 1.02a9.28 9.28 0 0 1 2.5-.34c.85 0 1.7.12 2.5.34 1.9-1.3 2.75-1.02 2.75-1.02.54 1.37.2 2.4.1 2.65.63.7 1.02 1.58 1.02 2.68 0 3.84-2.34 4.7-4.56 4.94.36.31.67.91.67 1.85l-.01 2.75c0 .26.19.58.69.48A10.02 10.02 0 0 0 22 12 10 10 0 0 0 12 2z"/></svg>Github
|
|
|
|
|
Repo</a>
|
|
|
|
|
|
|
|
|
|
</div>
|