Hoppa till innehåll

Du visar förhandsversionen av dokumentationenInnehållet här är för testning och kan skilja sig från den publika dokumentationen.

Gå till den publika dokumentationen

Översikt över självhosting

Kör din egen instans så stannar varje hemlighet, konto och loggrad på infrastruktur som du kontrollerar. Du bestämmer hur konton autentiseras, om instansen över huvud taget ska gå att nå från det publika internet, och vilken varumärkesprofil gränssnittet har.

Läget avgör vad mer som måste köras, så bestäm det innan du installerar.

simple är det levererade standardläget och behöver bara Valkey/Redis som datalager. full lägger till en SQL-databas för konton, som som standard är SQLite på sqlite://data/auth.db; PostgreSQL är ett alternativ som stöds, inte ett krav. I en container behöver den filen en monterad volym för att överleva en omstart.

Simple eller Full beskriver vad varje läge låser upp, var den databasen måste finnas och hur svårt det är att byta läge senare.

Har du bråttom och redan en Valkey eller Redis som du kör? Den enkla docker run-formen i Installera med Docker startar en instans på port 3000 med en genererad SECRET-nyckel. Allt annat på den här sidan gäller fortfarande när den är uppe.

  • Avbildningar och varianter – vilken av de publicerade avbildningarna du ska köra, och hur utgåvetaggarna fungerar.
  • Installera med Docker – de två Compose-stackarna som projektet levererar.
  • Installera på Linux – en installation direkt på maskinen med Debian eller Ubuntu. Ingen annan distributionsfamilj täcks av projektets installationstester.
  • Kör som en tjänst – de systemd-enheter som repositoriet levererar, och Procfile-körprogrammet för värdar utan systemd.
  • Omvänd proxy och TLS – applikationen terminerar aldrig TLS, så en proxy framför den förutsätts. Läs detta innan du exponerar instansen.
  • Verifiera din installation – bevisa att instansen verkligen betjänar trafik innan du lämnar över den till någon, och skapa det första kontot: rollen som webbplatsoperatör tilldelas enbart från CLI:t.

Uppgraderar du en befintlig installation? Uppgraderingsguiderna listar de tillgängliga guiderna, nyast först. Börja med den första guiden efter den utgåva du kör nu och arbeta dig framåt, och läs versionsinformationen för varje mellanliggande utgåva.

Rekommenderat för en instans som kör autentiseringsläget simple:

  • 2+ CPU-kärnor
  • 2GB+ RAM
  • 10GB+ diskutrymme

En driftsättning i full-läge som också kör PostgreSQL, bakgrundsarbetaren och schemaläggaren behöver ungefär dubbelt så mycket.

Visst administrativt arbete har ingen skärm i applikationen och utförs från instansens kommandorad.

Att överföra en organisation till en ny ägare är det viktigaste exemplet. Organisationsägare har ingen skärm eller slutpunkt för det, så det är du som måste utföra överföringen. Använd kommandot nedan. För automatisering exponerar Colonel-API:et samma operation på POST /api/colonel/organizations/:org_id/transfer-ownership; det kräver colonel-rollen, tar organisationens namn som bekräftelse och tillämpas omedelbart utan förhandsvisning.

Terminalfönster
bin/ots org transfer-ownership ORG NEW_OWNER

ORG är en organisations publika ID (extid, det ID som CLI:t skriver ut) eller dess interna ID (objid). NEW_OWNER är en e-postadress, en kunds extid eller ett Rodauth-konto-ID, och personen måste redan vara en aktiv medlem – kommandot skapar aldrig en kund, så kör bin/ots memberships add ORG CUSTOMER först om personen inte är det.

Kör det utan --yes så planerar det överföringen innan det rör något, skriver ut vem som förlorar ägarskapet, hur många ägarmedlemskap som skulle nedgraderas och till vad, och ber dig sedan bekräfta. Att svara n är sättet att förhandsgranska en överföring. Alternativen är --demote-to ROLE (vilken medlemskapsroll som helst utom owner, standard admin), --yes (även -y och -f) och --json.

Den avgående ägaren nedgraderas, tas inte bort. Operationen uppgraderar den nya ägaren innan den nedgraderar den gamla – skyddet mot att lämna organisationen utan ägare vägrar varje annan ordning – så under de två skrivningarna har organisationen två ägarmedlemskap och bin/ots org doctor rapporterar kontroll 4 (membership_role_sync) som en varning. Om en överföring avbryts inom det fönstret, kör överföringskommandot igen, inte org doctor. Överföringen är idempotent och nedgraderar varje annan ägare; org doctor markerar den kontrollen repairable: false och rättar inte till den.

Slutanvändarsidan av detta är Ägarskap och överföring, som är vad dina användare har läst innan de frågar dig.