Spring til indhold

Du ser forhåndsversionen af dokumentationenIndholdet her er til test og kan afvige fra den live dokumentation.

Gå til live dokumentation

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.

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.

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.

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.

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.

Terminalvindue
bin/ots org transfer-ownership ORG NEW_OWNER

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