Oversigt over selvhosting
Kør din egen instans, og hver besked, konto og loglinje bliver på infrastruktur, du kontrollerer. Du bestemmer, hvordan konti godkendes, om instansen overhovedet kan nås fra det offentlige internet, og hvilken branding grænsefladen har.
Vælg en godkendelsestilstand først
Afsnit med titlen “Vælg en godkendelsestilstand først”Tilstanden afgør, hvad der ellers skal køre, så beslut dig for den, før du installerer.
simple er standarden, som leveres, og kræver kun Valkey/Redis-datalageret. full tilføjer en SQL-database til konti, som som standard er SQLite på sqlite://data/auth.db; PostgreSQL er en understøttet mulighed, ikke et krav. I en container skal den fil ligge på et monteret volume for at overleve en genstart.
Simple eller Full gennemgår, hvad hver tilstand låser op for, hvor den database skal ligge, og hvor svært det er at skifte tilstand senere.
Vælg en installationsvej
Afsnit med titlen “Vælg en installationsvej”Har du travlt og en Valkey eller Redis, du allerede kører? Den enkelte docker run-form i Installér med Docker starter en instans på port 3000 med en genereret SECRET-værdi. Alt andet på denne side gælder stadig, når den kører.
- Images og varianter — hvilke af de udgivne images du skal køre, og hvordan udgivelsestags fungerer.
- Installér med Docker — de to Compose-stakke, projektet leverer.
- Installér på Linux — en bare-metal-installation på Debian eller Ubuntu. Ingen anden distributionsfamilie er dækket af projektets installationstests.
- Kør som en tjeneste — de systemd-units, repositoriet leverer, og Procfile-runneren til værter uden systemd.
- Reverse proxy og TLS — applikationen terminerer aldrig TLS, så en proxy foran den forudsættes. Læs dette, før du eksponerer instansen.
- Verificér din installation — bevis, at instansen reelt betjener forespørgsler, før du giver den til nogen, og opret den første konto: rollen som webstedsoperatør tildeles kun fra CLI’en.
Opgraderer du en eksisterende installation? Opgraderingsvejledningerne viser de tilgængelige vejledninger, nyeste først. Begynd med den første vejledning efter den udgivelse, du kører nu, arbejd dig fremad, og læs udgivelsesnoterne for hver mellemliggende udgivelse.
Systemkrav
Afsnit med titlen “Systemkrav”Anbefalet til en instans, der kører godkendelsestilstanden simple:
- 2+ CPU-kerner
- 2GB+ RAM
- 10GB+ diskplads
En full-tilstandsinstallation, der også kører PostgreSQL, baggrundsarbejderen og planlæggeren, kræver omtrent det dobbelte.
Handlinger kun for operatører
Afsnit med titlen “Handlinger kun for operatører”Noget administrativt arbejde har intet skærmbillede i applikationen og udføres fra instansens kommandolinje.
Overdragelse af en organisation til en ny ejer er den vigtigste. Organisationsejere har intet skærmbillede eller endepunkt til det, så det er dig, der skal udføre overdragelsen. Brug kommandoen nedenfor. Til automatisering udstiller Colonel API’et den samme handling på POST /api/colonel/organizations/:org_id/transfer-ownership; den kræver colonel-rollen, tager organisationens navn som bekræftelse og udføres straks uden forhåndsvisning.
bin/ots org transfer-ownership ORG NEW_OWNERORG er organisationens offentlige ID, kaldet extid (det ID, CLI’en udskriver), eller dens interne ID, kaldet objid. NEW_OWNER er en e-mailadresse, en kundes extid eller et Rodauth-konto-ID, og vedkommende skal allerede være et aktivt medlem — kommandoen opretter aldrig en kunde, så kør bin/ots memberships add ORG CUSTOMER først, hvis det ikke er tilfældet.
Kør den uden --yes, og den planlægger overdragelsen, før den rører noget: den udskriver, hvem der mister ejerskabet, hvor mange ejermedlemskaber der ville blive nedgraderet og til hvad, og beder dig derefter om at bekræfte. At svare n er måden at forhåndsvise en overdragelse på. Valgmulighederne er --demote-to ROLE (enhver medlemskabsrolle undtagen owner, standard admin), --yes (også -y og -f) og --json.
Den afgående ejer nedgraderes, ikke fjernes. Handlingen forfremmer den nye ejer, før den gamle nedgraderes — eneejer-sikringen afviser enhver anden rækkefølge — så i løbet af de to skrivninger har organisationen to ejermedlemskaber, og bin/ots org doctor rapporterer kontrol 4 (membership_role_sync) som en advarsel. Hvis en overdragelse afbrydes inden for det tidsrum, skal du køre overdragelseskommandoen igen, ikke org doctor. Overdragelsen er idempotent og nedgraderer alle andre ejere; org doctor markerer den kontrol som repairable: false og reparerer den ikke.
Slutbrugersiden af dette er Ejerskab og overdragelse, som er det, dine brugere vil have læst, før de spørger dig.
Få hjælp
Afsnit med titlen “Få hjælp”- GitHub-repositoriet for kildekoden, udgivelsesnoterne og de leverede Compose-stakke.
- Issue-trackeren for fejl, med udgivelsestagget og de relevante loglinjer.
- Kontakt os direkte om alt andet.