Преминаване към съдържанието

Преглеждате предварителния сайт с документацияСъдържанието тук е за тестване и може да се различава от продукционната документация.

Към продукционната документация

Преглед на самостоятелното хостване

Стартирайте собствен екземпляр и всяка тайна, всеки акаунт и всеки ред от журнала остават на инфраструктура, която вие контролирате. Вие решавате как се удостоверяват акаунтите, дали екземплярът изобщо е достъпен от публичния интернет и какво брандиране носи интерфейсът.

Режимът определя какво друго трябва да работи, затова го уточнете, преди да инсталирате.

simple е режимът по подразбиране и изисква само хранилището за данни Valkey/Redis. full добавя SQL база данни за акаунтите, която по подразбиране е SQLite на sqlite://data/auth.db; PostgreSQL е поддържана опция, а не изискване. В контейнер този файл се нуждае от монтиран том, за да преживее рестартиране.

Simple или Full описва какво отключва всеки режим, къде трябва да се намира тази база данни и колко трудно е режимът да се смени по-късно.

Бързате и вече имате работещ Valkey или Redis? Единичната команда docker run в Инсталиране с Docker стартира екземпляр на порт 3000 с един генериран ключ SECRET. Всичко останало на тази страница продължава да е в сила, след като екземплярът заработи.

  • Образи и варианти — кой от публикуваните образи да стартирате и как работят етикетите на изданията.
  • Инсталиране с Docker — двата Compose стека, които проектът доставя.
  • Инсталиране на Linux — инсталация на физически сървър с Debian или Ubuntu. Тестовете за инсталация на проекта не покриват друго семейство дистрибуции.
  • Стартиране като услуга — systemd единиците, които хранилището доставя, и Procfile изпълнителят за хостове без systemd.
  • Обратен прокси и TLS — приложението никога не терминира TLS, затова се предполага прокси пред него. Прочетете това, преди да направите екземпляра публично достъпен.
  • Проверете инсталацията си — уверете се, че екземплярът действително обслужва заявки, преди да го предадете на някого, и създайте първия акаунт: ролята на оператор на сайта се предоставя само от командния ред.

Надграждате съществуваща инсталация? Ръководствата за надграждане изброяват наличните ръководства, като най-новите са първи. Започнете с първото ръководство след изданието, което използвате сега, и продължете напред, като прочетете бележките към всяко междинно издание.

Препоръчително за екземпляр, работещ в режим на удостоверяване simple:

  • 2+ процесорни ядра
  • 2GB+ RAM
  • 10GB+ дисково пространство

Внедряване в режим full, което изпълнява също PostgreSQL, фоновия работен процес и планировчика, се нуждае от приблизително двойно повече.

Някои административни задачи нямат екран в приложението и се извършват от командния ред на екземпляра.

Прехвърлянето на организация към нов собственик е основната от тях. Собствениците на организации нямат екран или крайна точка за това, така че прехвърлянето е ваша задача. Използвайте командата по-долу. За автоматизация Colonel API предоставя същата операция на POST /api/colonel/organizations/:org_id/transfer-ownership; тя изисква ролята colonel, приема името на организацията като потвърждение и се прилага незабавно, без предварителен преглед.

Терминален прозорец
bin/ots org transfer-ownership ORG NEW_OWNER

ORG е публичният ИД на организацията (extid, който CLI отпечатва) или вътрешният ѝ ИД (objid). NEW_OWNER е имейл адрес, extid на клиент или ИД на Rodauth акаунт, и той трябва вече да е активен член — командата никога не създава клиент, затова първо изпълнете bin/ots memberships add ORG CUSTOMER, ако не е.

Изпълнете я без --yes и тя планира прехвърлянето, преди да промени каквото и да е, като отпечатва кой губи собствеността, колко членства на собственици ще бъдат понижени и до каква роля, след което ви иска потвърждение. Отговорът n е начинът да прегледате прехвърляне предварително. Опциите са --demote-to ROLE (всяка роля за членство освен owner, по подразбиране admin), --yes (също -y и -f) и --json.

Напускащият собственик се понижава, а не се премахва. Операцията повишава новия собственик, преди да понижи стария — защитата срещу липса на собственик отхвърля всяка друга последователност — така че за времето на тези два записа организацията има две членства на собственици и bin/ots org doctor отчита проверка 4 (membership_role_sync) като предупреждение. Ако прехвърлянето бъде прекъснато в този интервал, изпълнете командата за прехвърляне отново, а не org doctor. Прехвърлянето е идемпотентно и понижава всеки друг собственик; org doctor маркира тази проверка като repairable: false и не я поправя.

Страната на крайния потребител е описана в Собственост и прехвърляне — това е, което вашите потребители ще са прочели, преди да се обърнат към вас.