Kako Instalirati Castopod?

Zamišljeno je da Castopod bude jednostavan za instalaciju. Bilo da se koristi namenski ili deljeni hosting, možete ga instalirati na većinu PHP-MySQL kompatibilnih veb servera.

Note

Objavili smo zvanične Docker slike za Castopod!

Ako više volite da koristite Docker, možete ovo preskočiti i preći direktno na docker dokumentaciju za Castopod.

Uslovi

• PHP v8.3 ili novija verzija
• MySQL verzija 5.7 ili novija ili MariaDB verzija 10.2 ili novija
• HTTPS podrška
• ntp-sinhronizovani sat za potvrdu dolaznih zahteva federacije

PHP v8.3 ili kasnija verzija

Potrebna je PHP verzija 8.3 ili novija, sa instaliranim sledećim ekstenzijama:

• intl
• libcurl
• mbstring
• gd sa JPEG, PNG i WEBP bibliotekama.
• exif

Pored toga, uverite se da su sledeće ekstenzije omogućene u vašem PHP-u:

• json (podrazumevano omogućeno - ne isključujte ga)
• xml (podrazumevano omogućeno - ne isključujte ga)
• mysqlnd

MySQL kompatibilne baze podataka

Preporučujemo korišćenje MariaDB.

Note

Castopod radi samo sa podržanim MySQL 5.7 ili novijim kompatibilnim bazama podataka. Kvari se na MySQL v5.6 na primer, jer je njen životni vek istekao 5. februara 2021.

Trebaće vam ime servera, ime baze podataka, korisničko ime i lozinka za završite proces instalacije. Ako ih nemate, obratite se svom administratoru servera.

Privilegije

Korisnik mora imati najmanje ove privilegije u bazi podataka da bi Castopod radio: CREATE, ALTER, DELETE, EXECUTE, INDEX, INSERT, SELECT, UPDATE, REFERENCES, CREATE VIEW.

(Opciono) FFmpeg v4.1.8 ili kasnija verzija za video isečke

FFmpeg verzija 4.1.8 ili kasnija je neophodna ukoliko želite da pravite video isečke. Sledeće ekstenzije moraju biti instalirane:

• FreeType 2 biblioteka za gd.

(Opciono) Ostale preporuke

• Redis za bolje performanse keša.
• CDN za keširanje statičnih datoteka i bolje performanse.
• e-mail gateway za izgubljene lozinke.

Uputstva za instalaciju

Preduslovi

0. Nabavite veb server sa instaliranim preduslovima

1. Napravite MySQL bazu podataka za Castopod sa korisnikom koji ima pristup i privilegije da modifikuje (za više informacija, pogledajte MySQL kompatibilna baza podataka).

2. Aktivirajte HTTPS na vašem domenu sa SSL sertifikatom.

3. Preuzmite i otpakujte najnoviji Castopod Paket na veb server ako to već niste uradili.

   • ⚠️ Podesite root dokument veb servera na public/ poddirektorijum u okviru castopod direktorijuma.

4. Dodajte cron zadatke na vašem veb serveru za različite zadatke u pozadini (zamenite staze u skladu sa tim):

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

   Pažnja - ukoliko ne dodate ovaj cron zadatak, sledeće opcije Castopod-a neće raditi:

   • Uvoz podkasta iz postojeće RSS veze
   • Objava društvenih aktivnosti vašim pratiocima u Fediverzumu
   • Objava epizoda u otvorenim hub-ovima uz pomoć WebSub-a
   • Pravljenje video isečaka - zahteva FFmpeg

(preporučeno) Čarobnjak za instalaciju

1. Pokrenite Castopod-ovu instalacionu skriptu tako što ćete otići na stranicu čarobnjaka za instalaciju (https://your_domain_name.com/cp-install) u važem omiljenom pretraživaču.
2. Pratite uputstva na ekranu.
3. Počnite sa podkastingom!

Note

Instalaciona skripta upisuje .env datoteku u root paketa. Ukoliko ne možete da prođete kroz čarobnjaka za instalaciju, možete sami napraviti i urediti .env datoteku ručno po uzoru na .env.example datoteku.

Korišćenje CLI

1. Napravite .env datoteku u root-u paketa, po uzoru na .env.example datoteku.

2. Inicirajte bazu podataka koristeći:

   php spark install:init-database

3. Napravite super administratora koristeći:

   php spark install:create-superadmin

4. Idite na vaš administratorski pristup i krenite sa podkastingom!

Podešavanja Elektronske pošte/SMTP-a

Podešavanja elektronske pošte su potrebna kako bi neke opcije radile kako treba (npr. povratak izgubljene lozinke, slanje uputstava premijum pretplatnicima, …)

Možete dodati konfiguraciju elektronske pošte u vašu .env datoteku instance na sledeći način:

# […]

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

Opcije konfigurisanja elektronske pošte

Naziv promenljive	Vrsta	Podrazumevano
fromEmail	string	nedefinisano
fromName	string	"Castopod"
SMTPHost	string	nedefinisano
SMTPUser	string	nedefinisano
SMTPPass	string	nedefinisano
SMTPPort	number	25
SMTPCrypto	["tls" ili "ssl"]	"tls"

Multimedijalno skladište

Podrazumevano, datoteke se čuvaju u public/media direktorijumu koristeći sistem datoteka. Ukoliko želite da prebacite media direktorijum na drugo mesto, možete to odrediti u svojoj .env datoteci na način koji je prikazan ispod:

# […]

media.root="media"
media.storage="/mnt/storage"

U ovom primeru, datoteke će biti sačuvane u /mnt/storage/media direktorijumu. Obavezno ažurirajte konfiguraciju svog veb servera kako biste odrazili ovu promenu.

S3

Ako više volite da čuvate svoje medijske datoteke na S3 kompatibilnom skladištu, možete da ga navedete u svojoj .env datoteci:

# […]

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"

Opcije konfigurisanja S3 skladišta

Naziv promenljive	Vrsta	Podrazumevano
endpoint	string	nedefinisano
key	string	nedefinisano
secret	string	nedefinisano
region	string	nedefinisano
bucket	string	castopod
protocol	number	nedefinisano
pathStyleEndpoint	boolean	false
keyPrefix	string	nedefinisano

Paketi iz zajednice

Ukoliko ne želite da sami instalirate Castopod ručno, moežete iskoristiti jedan od paketa koji je napravila i o kome brine zajednica otvorenog koda.

Instalirajte sa YunoHost-om

YunoHost je je distribucija zasnovana na Debian GNU/Linux-u sačinjena od besplatnih softverskih paketa otvorenog koda. Ona upravlja teškoćama samo-hostovanje za vas.

Github Repo