castopod/docs/src/nl/getting-started/install.md

118 lines
4.8 KiB
Markdown
Raw Normal View History

2022-04-14 15:11:07 +02:00
---
title: Installatie
2022-04-14 15:11:07 +02:00
sidebarDepth: 3
---
# Hoe installeer ik Castopod?
2022-04-14 15:11:07 +02:00
Castopod is ontworpen om eenvoudig te installeren te zijn. Of je nu een
dedicated of shared hosting gebruikt, je kunt het installeren op de meeste
web servers die compatibel zijn met PHP-MySQL.
2022-04-14 15:11:07 +02:00
::: tip Opmerking
2022-08-22 17:56:51 +02:00
We hebben officiële Docker-afbeeldingen voor Castopod uitgebracht!
2022-07-04 15:27:21 +02:00
Als je Docker wilt gebruiken, kun je dit gedeelte overslaan en direct naar de [Docker-documentatie](./docker.md) voor Castopod gaan.
2022-07-04 15:27:21 +02:00
:::
## Vereisten
2022-04-14 15:11:07 +02:00
2023-06-21 19:17:32 +02:00
- PHP v8.1 only
- MySQL versie 5.7 of hoger of MariaDB versie 10.2 of hoger
- Ondersteuning voor HTTPS
- Een [ntp-gesynchroniseerde klok](https://wiki.debian.org/NTP) om binnenkomende verzoeken van de federatie te valideren
2022-04-14 15:11:07 +02:00
2023-06-21 19:17:32 +02:00
### PHP v8.1 only
2022-04-14 15:11:07 +02:00
PHP versie 8.1 is vereist, met de volgende geïnstalleerde extensies:
2022-04-14 15:11:07 +02:00
- [intl](https://www.php.net/manual/fr/intl.requirements.php)
- [libcurl](https://www.php.net/manual/fr/curl.requirements.php)
- [mbstring](https://www.php.net/manual/fr/mbstring.installation.php)
- [gd](https://www.php.net/manual/en/image.installation.php) met **JPEG**,
**PNG** en **WEBP** bibliotheken.
- [exif](https://www.php.net/manual/fr/exif.installation.php)
2022-04-14 15:11:07 +02:00
Zorg er daarnaast voor dat de volgende extensies zijn ingeschakeld in je PHP:
2022-04-14 15:11:07 +02:00
- json (standaard ingeschakeld - niet uitschakelen)
- xml (standaard ingeschakeld - niet uitschakelen)
- [mysqlnd](https://www.php.net/manual/fr/mysqlnd.install.php)
2022-04-14 15:11:07 +02:00
### Compatibele MySQL-database
2022-04-14 15:11:07 +02:00
> We raden aan om [MariaDB](https://mariadb.org) te gebruiken.
2022-04-14 15:11:07 +02:00
::: warning Let op
2022-04-14 15:11:07 +02:00
Castopod werkt alleen met MySQL-databases van versie 5.7 of hoger. Versies 5.6 (waarvan de ondersteuning op 5 februari 2021 is gestopt) of ouder werken niet.
2022-04-14 15:11:07 +02:00
:::
Je hebt de hostnaam van de server, de naam van de database, de gebruikersnaam en het wachtwoord nodig om het installatieproces te voltooien. Als je deze informatie niet hebt, neem dan contact op met je beheerder.
2022-04-14 15:11:07 +02:00
#### Toegangsrechten
2022-04-14 15:11:07 +02:00
De gebruiker moet in ieder geval de volgende toegangsrechten hebben op de database om Castopod te laten werken: `CREATE`, `ALTER`, `DELETE`, `EXECUTE`,
`INDEX`,`INSERT`, `SELECT`, `UPDATE`,`REFERENCES`, `CREATE VIEW`.
2022-04-14 15:11:07 +02:00
### (Optioneel) FFmpeg v4.1.8 of hoger voor videoclips
2022-04-14 15:11:07 +02:00
[FFmpeg](https://www.ffmpeg.org/) versie 4.1.8 of hoger is vereist als je videoclips wilt genereren. De volgende extensies moeten zijn geïnstalleerd:
2022-04-14 15:11:07 +02:00
- **FreeType 2** bibliotheek voor [gd](https://www.php.net/manual/en/image.installation.php).
2022-04-14 15:11:07 +02:00
### (Optioneel) Andere aanbevelingen
2022-04-14 15:11:07 +02:00
- Redis voor betere cache-prestaties.
- CDN voor het cachen van statische bestanden en betere prestaties.
- E-mail gateway voor verloren wachtwoorden.
2022-04-14 15:11:07 +02:00
## Installatie-instructies
2022-04-14 15:11:07 +02:00
### Vereisten
2022-04-14 15:11:07 +02:00
0. Verkrijg een webserver met de geïnstalleerde [vereisten](#vereisten)
1. Maak een MySQL-database aan voor Castopod met een gebruiker met de juiste toegangsrechten en bewerkingsrechten (zie [compatibele MySQL-database](#comptible-mysql-database) voor meer informatie).
2. Zorg ervoor dat HTTPS is ingeschakeld op je domein met een _SSL-certificaat_.
3. Download en unzip het laatste [Castopod-pakket](https://castopod.org/) op de webserver als je dat nog niet hebt gedaan.
- ⚠️ Zorg ervoor dat de rootmap van het webdocument verwijst naar de `public/` submap van de `castopod` map.
4. Voeg **cron-taken** toe aan je webserver voor verschillende achtergrondprocessen (vervang de paden dienovereenkomstig):
2022-04-14 15:11:07 +02:00
```bash
* * * * * /pad/naar/php /pad/naar/castopod/spark tasks:run >> /dev/null 2>&1
2022-04-14 15:11:07 +02:00
```
**Opmerking** - Als je deze cron-taak niet toevoegt, werken de volgende Castopod-functies niet:
2022-04-14 15:11:07 +02:00
- Het importeren van een podcast uit een bestaande RSS-feed
- Het delen van sociale activiteiten met je volgers in het Fediverse
- Het uitzenden van afleveringen naar open hubs met behulp van [WebSub](https://en.wikipedia.org/wiki/WebSub)
- Het genereren van videoclips - [vereist FFmpeg](#optioneel-ffmpeg-v418-of-hoger-voor-videoclips)
2022-04-14 15:11:07 +02:00
### (Aanbevolen methode) Installatiewizard
2022-04-14 15:11:07 +02:00
1. Voer het Castopod-installatiescript uit door naar de installatiewizard-pagina (`https://your_domain_name.com/cp-install`) te gaan in je favoriete webbrowser.
2. Volg de weergegeven instructies.
3. Begin met podcasten!
2022-04-14 15:11:07 +02:00
:::info Opmerking
2022-04-14 15:11:07 +02:00
Het installatiescript maakt een `.env`-bestand aan in de hoofdmap van het pakket. Als je de installatiewizard niet kunt gebruiken, kun je het `.env`-bestand handmatig maken en bewerken op basis van het `.env.example`-bestand.
2022-04-14 15:11:07 +02:00
:::
### E-mail/SMTP-configuratie
2022-10-14 18:12:14 +02:00
E-mailconfiguratie is vereist voor sommige functies om correct te werken (bijv. het ophalen van je vergeten wachtwoord, het verzenden van instructies naar premium-abonnees, ...)
2022-10-14 18:12:14 +02:00
Je kunt je e-mailconfiguratie toevoegen aan het `.env`-bestand van je Castopod-instantie zoals hieronder weergegeven:
2022-10-14 18:12:14 +02:00
```ini
# [...]
2022-10-14 18:12:14 +02:00
email.fromEmail="your_email_address"
email.SMTPHost="your_smtp_host"
email.SM