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

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:

# […]

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

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`
`pathStyleEndpoint`	boolean	`false`
`keyPrefix`	string	`undefined`

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.4 KiB Raw Blame History