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.
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:
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.
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
-
Nabavite veb server sa instaliranim preduslovima
-
Napravite MySQL bazu podataka za Castopod sa korisnikom koji ima pristup i privilegije da modifikuje (za više informacija, pogledajte MySQL kompatibilna baza podataka).
-
Aktivirajte HTTPS na vašem domenu sa SSL sertifikatom.
-
Preuzmite i otpakujte najnoviji Castopod Paket na veb server ako to već niste uradili.
- ⚠️ Podesite root dokument veb servera na
public/
poddirektorijum u okvirucastopod
direktorijuma.
- ⚠️ Podesite root dokument veb servera na
-
Dodajte cron zadatke na vašem veb serveru za različite zadatke u pozadini (zamenite staze u skladu sa tim):
Terminal window * * * * * /path/to/php /path/to/castopod/spark tasks:run >> /dev/null 2>&1Paž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
- 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. - Pratite uputstva na ekranu.
- Počnite sa podkastingom!
Korišćenje CLI
-
Napravite
.env
datoteku u root-u paketa, po uzoru na.env.example
datoteku. -
Inicirajte bazu podataka koristeći:
Terminal window php spark install:init-database -
Napravite super administratora koristeći:
Terminal window php spark install:create-superadmin -
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.