install.md

title: Installation
sidebarDepth: 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

0. Skaffa en webbserver med krav 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).

2. Aktivera HTTPS på din domän med ett SSL-certifikat.

3. 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.

4. Add cron tasks on your web server for various background processes (replace the paths accordingly):

      * * * * * /path/to/php /path/to/castopod/spark tasks:run >> /dev/null 2>&1

   Note - If you do not add this cron task, the following Castopod features will not work:

   • Importing a podcast from an existing RSS feed
   • Broadcasting social activities to your followers in the fediverse
   • Broadcasting episodes to open hubs using WebSub
   • Generating video clips - requires FFmpeg

(rekommenderas) Installationsguide

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!

::: 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.

:::

Using CLI

1. Create a .env file in the package root based on the .env.example file.

2. Initialize the database using:

   php spark install:init-database

3. Create the superadmin user using:

   php spark install:create-superadmin

4. Head on to your admin gateway to start podcasting!

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