2022-04-14 15:11:07 +02:00
|
|
|
---
|
|
|
|
title: Installation
|
|
|
|
sidebarDepth: 3
|
|
|
|
---
|
|
|
|
|
2022-11-04 12:03:24 +01:00
|
|
|
# Hur man installerar Castopod?
|
2022-04-14 15:11:07 +02:00
|
|
|
|
2022-11-04 12:03:24 +01:00
|
|
|
Castopod var tänkt att vara lätt att installera. Oavsett om du använder
|
|
|
|
dedikerade eller delade webbhotell kan du installera det på de flesta
|
|
|
|
PHP-MySQL-kompatibla webbservrar.
|
2022-04-14 15:11:07 +02:00
|
|
|
|
2022-11-04 12:03:24 +01:00
|
|
|
::: tips Anteckning
|
2022-08-22 17:56:51 +02:00
|
|
|
|
2022-11-04 12:03:24 +01:00
|
|
|
Vi har släppt officiella Docker-bilder för Castopod!
|
2022-07-04 15:27:21 +02:00
|
|
|
|
2022-11-04 12:03:24 +01:00
|
|
|
Om du föredrar att använda Docker, kan du hoppa över detta och gå direkt till
|
|
|
|
[dockerdokumentationen](./docker.md) för Castopod.
|
2022-07-04 15:27:21 +02:00
|
|
|
|
|
|
|
:::
|
|
|
|
|
2022-11-04 12:03:24 +01:00
|
|
|
## Krav
|
2022-04-14 15:11:07 +02:00
|
|
|
|
2022-10-17 16:17:50 +02:00
|
|
|
- PHP v8.1 or higher
|
2022-11-04 12:03:24 +01:00
|
|
|
- MySQL version 5.7 eller högre eller MariaDB version 10.2 eller högre
|
|
|
|
- Stöd för HTTPS
|
2022-04-14 15:11:07 +02:00
|
|
|
|
2022-10-17 16:17:50 +02:00
|
|
|
### PHP v8.1 or higher
|
2022-04-14 15:11:07 +02:00
|
|
|
|
2022-10-17 16:17:50 +02:00
|
|
|
PHP version 8.1 or higher is required, with the following extensions installed:
|
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)
|
2022-11-04 12:03:24 +01:00
|
|
|
- [gd](https://www.php.net/manual/en/image.installation.php) med **JPEG**,
|
|
|
|
**PNG** och **WEBP** bibliotek.
|
2022-04-14 15:11:07 +02:00
|
|
|
- [exif](https://www.php.net/manual/en/exif.installation.php)
|
|
|
|
|
2022-11-04 12:03:24 +01:00
|
|
|
Se dessutom till att följande tillägg är aktiverade i din PHP:
|
2022-04-14 15:11:07 +02:00
|
|
|
|
2022-11-04 12:03:24 +01:00
|
|
|
- json (aktiverad som standard - stäng inte av)
|
|
|
|
- xml (aktiverat som standard - stäng inte av)
|
2022-04-14 15:11:07 +02:00
|
|
|
- [mysqlnd](https://php.net/manual/en/mysqlnd.install.php)
|
|
|
|
|
2022-11-04 12:03:24 +01:00
|
|
|
### MySQL kompatibel databas
|
2022-04-14 15:11:07 +02:00
|
|
|
|
2022-11-04 12:03:24 +01:00
|
|
|
> Vi rekommenderar att du använder [MariaDB](https://mariadb.org).
|
2022-04-14 15:11:07 +02:00
|
|
|
|
2022-11-04 12:03:24 +01:00
|
|
|
::: varning Varning
|
2022-04-14 15:11:07 +02:00
|
|
|
|
2022-11-04 12:03:24 +01:00
|
|
|
Castopod fungerar endast med stödda MySQL 5.7 eller högre kompatibla databaser.
|
|
|
|
Den kommer att bryta med den tidigare MySQL v5.6 till exempel eftersom dess slut
|
|
|
|
var den 5 februari 2021.
|
2022-04-14 15:11:07 +02:00
|
|
|
|
|
|
|
:::
|
|
|
|
|
2022-11-04 12:03:24 +01:00
|
|
|
Du behöver serverns värdnamn, databasnamn, användarnamn och lösenord för att
|
|
|
|
slutföra installationen. Om du inte har dessa kontaktar du din
|
|
|
|
serveradministratör.
|
2022-04-14 15:11:07 +02:00
|
|
|
|
2022-11-04 12:03:24 +01:00
|
|
|
#### Privilegier
|
2022-04-14 15:11:07 +02:00
|
|
|
|
2022-11-04 12:03:24 +01:00
|
|
|
Användare måste ha minst dessa rättigheter i databasen för att Castopod ska
|
|
|
|
fungera: `CREATE`, `ALTER`, `DELETE`, `EXECUTE`, `INDEX`, `INSERT`, `SELECT`,
|
|
|
|
`UPDATE`, `REFERENCES`, `CREATE VIEW`.
|
2022-04-14 15:11:07 +02:00
|
|
|
|
2022-11-04 12:03:24 +01:00
|
|
|
### (Valfritt) FFmpeg v4.1.8 eller högre för videoklipp
|
2022-04-14 15:11:07 +02:00
|
|
|
|
2022-11-04 12:03:24 +01:00
|
|
|
[FFmpeg](https://www.ffmpeg.org/) version 4.1.8 eller högre krävs om du vill
|
|
|
|
generera videoklipp. Följande tillägg måste installeras:
|
2022-04-14 15:11:07 +02:00
|
|
|
|
2022-11-04 12:03:24 +01:00
|
|
|
- **FreeType 2** bibliotek för
|
2022-04-14 15:11:07 +02:00
|
|
|
[gd](https://www.php.net/manual/en/image.installation.php).
|
|
|
|
|
2022-11-04 12:03:24 +01:00
|
|
|
### (Valfritt) Andra rekommendationer
|
2022-04-14 15:11:07 +02:00
|
|
|
|
2022-11-04 12:03:24 +01:00
|
|
|
- Redis för bättre cache-prestanda.
|
|
|
|
- CDN för statiska filer caching och bättre prestanda.
|
|
|
|
- e-post gateway för förlorade lösenord.
|
2022-04-14 15:11:07 +02:00
|
|
|
|
2022-11-04 12:03:24 +01:00
|
|
|
## Installationsanvisningar
|
2022-04-14 15:11:07 +02:00
|
|
|
|
2022-11-04 12:03:24 +01:00
|
|
|
### Förutsättningar
|
2022-04-14 15:11:07 +02:00
|
|
|
|
2022-11-04 12:03:24 +01:00
|
|
|
0. Skaffa en webbserver med [krav](#requirements) installerat
|
|
|
|
1. Skapa en MySQL-databas för Castopod med en användare som har åtkomst till och
|
|
|
|
modifieringsrättigheter (för mer info, se
|
|
|
|
[MySQL-kompatibel databas](#mysql-compatible-database)).
|
|
|
|
2. Aktivera HTTPS på din domän med ett _SSL-certifikat_.
|
|
|
|
3. Ladda ner och packa upp det senaste [Castopod Package](https://castopod.org/)
|
|
|
|
på webbservern om du inte redan har det.
|
|
|
|
- ⚠️ Sätt webbserverdokumentroten till `public/` undermappen i mappen
|
|
|
|
`castopod`.
|
|
|
|
4. Lägg till **cron-uppgifter** på din webbserver för olika bakgrundsprocesser
|
|
|
|
(byt ut sökvägarna därefter):
|
2022-04-14 15:11:07 +02:00
|
|
|
|
2022-11-04 12:03:24 +01:00
|
|
|
- För att sociala funktioner ska fungera korrekt, används denna uppgift för
|
|
|
|
att sända sociala aktiviteter till dina anhängare på fediverse:
|
2022-04-14 15:11:07 +02:00
|
|
|
|
|
|
|
```bash
|
|
|
|
* * * * * /path/to/php /path/to/castopod/public/index.php scheduled-activities
|
|
|
|
```
|
|
|
|
|
2022-11-04 12:03:24 +01:00
|
|
|
- För att dina episoder ska sändas på öppna hubbar vid publicering med
|
2022-04-14 15:11:07 +02:00
|
|
|
[WebSub](https://en.wikipedia.org/wiki/WebSub):
|
|
|
|
|
|
|
|
```bash
|
|
|
|
* * * * * /usr/local/bin/php /castopod/public/index.php scheduled-websub-publish
|
|
|
|
```
|
|
|
|
|
2022-11-04 12:03:24 +01:00
|
|
|
- För att videoklipp ska skapas (se
|
|
|
|
[FFmpeg krav](#ffmpeg-v418-or-higher-for-video-clips)):
|
2022-04-14 15:11:07 +02:00
|
|
|
|
|
|
|
```bash
|
|
|
|
* * * * * /path/to/php /path/to/castopod/public/index.php scheduled-video-clips
|
|
|
|
```
|
|
|
|
|
2022-11-04 12:03:24 +01:00
|
|
|
> Dessa uppgifter körs **varje minut**. Du kan ställa in frekvensen beroende
|
|
|
|
> på dina behov: var 5, 10 minuter eller mer.
|
2022-04-14 15:11:07 +02:00
|
|
|
|
2022-11-04 12:03:24 +01:00
|
|
|
### (rekommenderas) Installationsguide
|
2022-04-14 15:11:07 +02:00
|
|
|
|
2022-11-04 12:03:24 +01:00
|
|
|
1. Kör Castopod install script genom att gå till installationsguiden sidan
|
|
|
|
(`https://your_domain_name.com/cp-install`) i din favorit webbläsare.
|
|
|
|
2. Följ instruktionerna på din enhet.
|
|
|
|
3. Börja podcasting!
|
2022-04-14 15:11:07 +02:00
|
|
|
|
2022-11-04 12:03:24 +01:00
|
|
|
::: info Notering
|
2022-04-14 15:11:07 +02:00
|
|
|
|
2022-11-04 12:03:24 +01:00
|
|
|
Installationsskriptet skriver en `.env` -fil i paketroten. Om du inte kan gå via
|
|
|
|
installationsguiden kan du skapa och redigera `. nv` filen manuellt baserat på
|
|
|
|
`.env.example` filen.
|
2022-04-14 15:11:07 +02:00
|
|
|
|
|
|
|
:::
|
|
|
|
|
2022-10-14 18:12:14 +02:00
|
|
|
### Email/SMTP setup
|
|
|
|
|
2022-11-04 12:03:24 +01:00
|
|
|
E-postkonfiguration krävs för att vissa funktioner ska fungera korrekt (t.ex.
|
|
|
|
att hämta ditt glömda lösenord, skicka instruktioner till premiumprenumeranter,
|
2022-10-14 18:12:14 +02:00
|
|
|
…)
|
|
|
|
|
2022-11-04 12:03:24 +01:00
|
|
|
Du kan lägga till din e-postkonfiguration i din instans `.env` som så:
|
2022-10-14 18:12:14 +02:00
|
|
|
|
|
|
|
```ini
|
|
|
|
# […]
|
|
|
|
|
|
|
|
email.fromEmail="your_email_address"
|
|
|
|
email.SMTPHost="your_smtp_host"
|
|
|
|
email.SMTPUser="your_smtp_user"
|
|
|
|
email.SMTPPass="your_smtp_password"
|
|
|
|
```
|
|
|
|
|
2022-11-04 12:03:24 +01:00
|
|
|
#### Alternativ för e-postkonfiguration
|
2022-10-14 18:12:14 +02:00
|
|
|
|
2022-11-04 12:03:24 +01:00
|
|
|
| Variabelt namn | Typ | Standard |
|
|
|
|
| ---------------- | ----------------------- | ------------- |
|
|
|
|
| **`fromEmail`** | sträng | `odefinierad` |
|
|
|
|
| **`fromName`** | sträng | `"Castopod"` |
|
|
|
|
| **`SMTPHost`** | sträng | `odefinierad` |
|
|
|
|
| **`SMTPUser`** | sträng | `odefinierad` |
|
|
|
|
| **`SMTPPass`** | sträng | `odefinierad` |
|
|
|
|
| **`SMTPPort`** | nummer | `25` |
|
|
|
|
| **`SMTPCrypto`** | [`"tls"` eller `"ssl"`] | `"tls"` |
|
2022-10-14 18:12:14 +02:00
|
|
|
|
2022-11-04 12:03:24 +01:00
|
|
|
## Gemenskapspaket
|
2022-04-14 15:11:07 +02:00
|
|
|
|
2022-11-04 12:03:24 +01:00
|
|
|
Om du inte vill bry dig om att installera Castopod manuellt, kan du använda ett
|
|
|
|
av de paket som skapats och underhålls av open source-miljön.
|
2022-04-14 15:11:07 +02:00
|
|
|
|
2022-11-04 12:03:24 +01:00
|
|
|
### Installera med YunoHost
|
2022-04-14 15:11:07 +02:00
|
|
|
|
2022-11-04 12:03:24 +01:00
|
|
|
[YunoHost](https://yunohost.org/) är en distribution baserad på Debian GNU/Linux
|
|
|
|
som består av mjukvarupaket med fri och öppen källkod. Det hanterar
|
|
|
|
svårigheterna med self-hosting för dig.
|
2022-04-14 15:11:07 +02:00
|
|
|
|
|
|
|
<div class="flex flex-wrap items-center gap-4">
|
|
|
|
|
|
|
|
<a href="https://install-app.yunohost.org/?app=castopod" target="_blank" rel="noopener noreferrer">
|
2022-11-04 12:03:24 +01:00
|
|
|
<img src="https://install-app.yunohost.org/install-with-yunohost.svg" alt="Installera Castopod med YunoHost" class="align-middle" />
|
2022-04-14 15:11:07 +02:00
|
|
|
</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>
|