8.0 KiB

Raw Blame History

title	sidebarDepth
Installation	3

Hur man installerar Castopod?

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.

::: tips Anteckning

Vi har släppt officiella Docker-bilder för Castopod!

Om du föredrar att använda Docker, kan du hoppa över detta och gå direkt till dockerdokumentationen för Castopod.

:::

Krav

PHP v8.1 or higher
MySQL version 5.7 eller högre eller MariaDB version 10.2 eller högre
Stöd för HTTPS
An ntp-synced clock to validate federation's incoming requests

PHP v8.1 or higher

PHP version 8.1 or higher is required, with the following extensions installed:

intl
libcurl
mbstring
gd med JPEG, PNG och WEBP bibliotek.
exif

Se dessutom till att följande tillägg är aktiverade i din PHP:

json (aktiverad som standard - stäng inte av)
xml (aktiverat som standard - stäng inte av)
mysqlnd

MySQL kompatibel databas

Vi rekommenderar att du använder MariaDB.

::: varning Varning

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.

:::

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.

Privilegier

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.

(Valfritt) FFmpeg v4.1.8 eller högre för videoklipp

FFmpeg version 4.1.8 eller högre krävs om du vill generera videoklipp. Följande tillägg måste installeras:

FreeType 2 bibliotek för gd.

(Valfritt) Andra rekommendationer

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.

Installationsanvisningar

Förutsättningar

Skaffa en webbserver med krav installerat
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).
Aktivera HTTPS på din domän med ett SSL-certifikat.
Ladda ner och packa upp det senaste Castopod Package på webbservern om du inte redan har det.
- ⚠️ Sätt webbserverdokumentroten till public/ undermappen i mappen castopod.
Lägg till cron-uppgifter på din webbserver för olika bakgrundsprocesser (byt ut sökvägarna därefter):
- 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:
```
   * * * * * /path/to/php /path/to/castopod/public/index.php scheduled-activities
```
- För att dina episoder ska sändas på öppna hubbar vid publicering med WebSub:
```
   * * * * * /usr/local/bin/php /castopod/public/index.php scheduled-websub-publish
```
- För att videoklipp ska skapas (se FFmpeg krav):
```
   * * * * * /path/to/php /path/to/castopod/public/index.php scheduled-video-clips
```
Dessa uppgifter körs varje minut. Du kan ställa in frekvensen beroende på dina behov: var 5, 10 minuter eller mer.

(rekommenderas) Installationsguide

Kör Castopod install script genom att gå till installationsguiden sidan (https://your_domain_name.com/cp-install) i din favorit webbläsare.
Följ instruktionerna på din enhet.
Börja podcasting!

::: info Notering

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.

:::

Email/SMTP setup

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, …)

Du kan lägga till din e-postkonfiguration i din instans .env som så:

# […]

email.fromEmail="your_email_address"
email.SMTPHost="your_smtp_host"
email.SMTPUser="your_smtp_user"
email.SMTPPass="your_smtp_password"

Alternativ för e-postkonfiguration

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"`

S3

By default, files are stored in the public/media folder using the filesystem.

If you prefer storing your media files on an S3 compatible storage, you may specify it in your .env:

# […]

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

Variable name	Type	Default
`endpoint`	string	`undefined`
`key`	string	`undefined`
`secret`	string	`undefined`
`region`	string	`undefined`
`bucket`	string	`castopod`
`protocol`	number	`undefined`
`path_style_endpoint`	boolean	`false`

Gemenskapspaket

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.

Github Repo

8.0 KiB Raw Blame History