install.md

title: Installering
sidebarDepth: 3

Korleis installerer eg Castopod?

Det er meininga at Castopod skal vera lett å installera. Uansett om du bruker eige eller delt vevhotell, kan du installera på dei fleste maskiner som har PHP og MySQL.

::: tip Note

We've released official Docker images for Castopod!

If you prefer using Docker, you may skip this and go straight to the docker documentation for Castopod.

:::

Krav

• PHP v8.1 eller nyare
• MySQL versjon 5.7 eller nyare, eller MariaDB versjon 10.2 eller nyare
• Støtte for HTTPS

PHP v8.1 eller nyare

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

• intl
• libcurl
• mbstring
• gd med JPEG-, PNG- og WEBP-biblioteka.
• exif

Additionally, make sure that the following extensions are enabled in your PHP:

• json (vanlegvis aktivt - ikkje skru det av)
• xml (vanlegvis aktivt - ikkje skru det av)
• mysqlnd

MySQL-kompatibel database

Me tilrår MariaDB.

::: warning Warning

Castopod only works with supported MySQL 5.7 or higher compatible databases. It will break with the previous MySQL v5.6 for example as its end of life was on February 5, 2021.

:::

You will need the server hostname, database name, username and password to complete the installation process. If you do not have these, please contact your server administrator.

Tilgangsrettar

User must have at least these privileges on the database for Castopod to work: CREATE, ALTER, DELETE, EXECUTE, INDEX, INSERT, SELECT, UPDATE, REFERENCES, CREATE VIEW.

(Eventuelt) FFmpeg v4.1.8 eller nyare for filmklypp

FFmpeg version 4.1.8 or higher is required if you want to generate Video Clips. The following extensions must be installed:

• FreeType 2-biblioteket for gd.

(Eventuelt) Andre tilrådingar

• Redis for betre bufring.
• Innhaldsnettverk (CDN) for å bufra statiske filer og betra ytinga.
• Epostløysing for å nullstilla passord.

Korleis du installerer

Føresetnader

0. Få tak i ein vevtenar som fyller krava

1. Lag ein MySQL-database for Castopod der brukaren har tilgangs- og endringsløyve (les meir om MySQL-database).

2. Ta i bruk HTTPS på domenet ditt ved hjelp av eit SSL-sertifikat.

3. Last ned og pakk ut den nyaste Castopod-pakka på vevtenaren din, om du ikkje allereie har gjort det.

   • ⚠️ Set dokumentrota til vevtenaren til undermappa public/ i castopod-mappa.

4. Lag cron-oppgåver på vevtenaren din for ulike bakgrunnsprosessar (byt ut stiane så dei passar til oppsettet ditt):

   • For at sosiale funksjonar skal fungera, trengst denne oppgåva for å kringkasta sosiale aktivitetar til fylgjarane dine på fødiverset:

      * * * * * /sti/til/php /sti/til/castopod/public/index.php scheduled-activities

   • For å kringkasta episodane på opne nettnav som bruker WebSub:

      * * * * * /usr/local/bin/php /castopod/public/index.php scheduled-websub-publish

   • For å laga filmklypp (sjå FFmpeg-krava):

      * * * * * /sti/til/php /sti/til/castopod/public/index.php scheduled-video-clips

   Desse oppgåvene blir utførte kvart minutt. Du kan setja opp kor ofte du treng å utføra oppgåvene: kvart 5., 10. minutt eller meir.

(Tilrådd) Autoinstallering

1. Køyr Castopod-installasjonen ved å gå til autoinstalleringssida (https://domenet_ditt.no/cp-install) i nettlesaren din.
2. Fylg framgangsmåten på skjermen.
3. Start å podkasta!

::: info Note

The install script writes a .env file in the package root. If you cannot go through the install wizard, you can create and edit the .env file manually based on the .env.example file.

:::

Email/SMTP setup

Email configuration is required for some features to work properly (eg. retrieving your forgotten password, sending instructions to premium subscribers, …)

You may add your email configuration in your instance's .env like so:

# […]

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

Email config options

Variable name	Type	Default
fromEmail	string	undefined
fromName	string	"Castopod"
SMTPHost	string	undefined
SMTPUser	string	undefined
SMTPPass	string	undefined
SMTPPort	number	25
SMTPCrypto	["tls" or "ssl"]	"tls"

Pakker frå brukarsamfunnet

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-arkiv