# Przegląd self-hostingu

> Co wiąże się z uruchomieniem własnej instancji Onetime Secret, który tryb uwierzytelniania wybrać na początku i gdzie znaleźć instrukcje instalacji i obsługi.

Uruchom własną instancję, a każdy sekret, każde konto i każda linia logów pozostaną na infrastrukturze, którą kontrolujesz. To Ty decydujesz, jak uwierzytelniane są konta, czy instancja jest w ogóle dostępna z publicznego internetu i jaki branding nosi interfejs.

## Najpierw wybierz tryb uwierzytelniania

Tryb decyduje o tym, co jeszcze musi działać, więc ustal go przed instalacją.

`simple` to domyślny tryb w dostarczanej konfiguracji i wymaga jedynie magazynu danych Valkey/Redis. `full` dodaje bazę danych SQL dla kont, która domyślnie korzysta z SQLite pod adresem `sqlite://data/auth.db`; PostgreSQL jest obsługiwaną opcją, a nie wymogiem. W kontenerze ten plik potrzebuje zamontowanego wolumenu, aby przetrwać restart.

[Simple czy Full](/en/self-hosting/simple-or-full-auth) wyjaśnia, co odblokowuje każdy tryb, gdzie musi znajdować się ta baza danych i jak trudno później zmienić tryb.

## Wybierz ścieżkę instalacji

Spieszysz się i masz już działający Valkey lub Redis? Pojedyncze polecenie `docker run` z [Instalacji z Dockerem](/en/install/docker#running-a-single-container) uruchamia instancję na porcie 3000 z wygenerowaną wartością `SECRET`. Wszystko pozostałe na tej stronie nadal obowiązuje, gdy instancja już działa.

* [Obrazy i warianty](/en/install/images-and-variants) — który z publikowanych obrazów uruchomić i jak działają tagi wydań.
* [Instalacja z Dockerem](/en/install/docker) — dwa stosy Compose, które projekt dostarcza.
* [Instalacja na Linuksie](/en/install/linux) — instalacja bare-metal na Debianie lub Ubuntu. Testy instalacji projektu nie obejmują żadnej innej rodziny dystrybucji.
* [Uruchamianie jako usługa](/en/install/run-as-a-service) — jednostki systemd dostarczane w repozytorium oraz runner Procfile dla hostów bez systemd.
* [Reverse proxy i TLS](/en/install/reverse-proxy-and-tls) — aplikacja nigdy nie terminuje TLS, więc zakłada się proxy przed nią. Przeczytaj to, zanim wystawisz instancję na zewnątrz.
* [Weryfikacja instalacji](/en/install/verify) — upewnij się, że instancja faktycznie działa, zanim przekażesz ją komukolwiek, i [utwórz pierwsze konto](/en/install/verify#create-the-first-account): rola operatora witryny jest nadawana wyłącznie z CLI.

Aktualizujesz istniejącą instalację? [Przewodniki aktualizacji](/en/self-hosting/upgrade-guides) wymieniają dostępne przewodniki, od najnowszego. Zacznij od pierwszego przewodnika po wydaniu, które obecnie uruchamiasz, i przechodź dalej, czytając informacje o wydaniu dla każdego wydania pośredniego.

## Wymagania systemowe

Zalecane dla instancji działającej w trybie uwierzytelniania `simple`:

* 2+ rdzenie CPU
* 2 GB+ RAM
* 10 GB+ przestrzeni dyskowej

Wdrożenie w trybie full, które uruchamia także PostgreSQL, proces roboczy w tle i harmonogram, potrzebuje mniej więcej dwa razy tyle.

## Działania wyłącznie dla operatora

Część prac administracyjnych nie ma ekranu w aplikacji i wykonuje się ją z wiersza poleceń instancji.

Najważniejsze z nich to przeniesienie organizacji na nowego właściciela. Właściciele organizacji nie mają do tego ekranu ani punktu końcowego, więc przeniesienie należy do Ciebie. Użyj poniższego polecenia. Do automatyzacji Colonel API udostępnia tę samą operację pod adresem `POST /api/colonel/organizations/:org_id/transfer-ownership`; wymaga ona roli colonel, przyjmuje nazwę organizacji jako potwierdzenie i jest stosowana natychmiast, bez podglądu.

```bash
bin/ots org transfer-ownership ORG NEW_OWNER
```

`ORG` to publiczny identyfikator organizacji (`extid`, ten, który wypisuje CLI) lub jej wewnętrzny identyfikator (`objid`). `NEW_OWNER` to adres e-mail, extid klienta lub identyfikator konta Rodauth, a osoba ta **musi już być aktywnym członkiem** — polecenie nigdy nie tworzy klienta, więc jeśli nim nie jest, najpierw uruchom `bin/ots memberships add ORG CUSTOMER`.

Uruchomione bez `--yes` planuje przeniesienie, zanim czegokolwiek dotknie: wypisuje, kto traci własność, ile członkostw właściciela zostałoby zdegradowanych i do jakiej roli, a następnie prosi o potwierdzenie. Odpowiedź `n` to sposób na podgląd przeniesienia. Dostępne opcje to `--demote-to ROLE` (dowolna rola członkostwa poza `owner`, domyślnie `admin`), `--yes` (także `-y` i `-f`) oraz `--json`.

Dotychczasowy właściciel zostaje zdegradowany, a nie usunięty. Operacja awansuje nowego właściciela, zanim zdegraduje poprzedniego — zabezpieczenie przed brakiem właściciela odrzuca każdą inną kolejność — więc przez czas trwania tych dwóch zapisów organizacja ma dwa członkostwa właściciela, a `bin/ots org doctor` zgłasza kontrolę 4 (`membership_role_sync`) jako ostrzeżenie. Jeśli przeniesienie zostanie przerwane w tym oknie, uruchom polecenie przeniesienia ponownie, a nie `org doctor`. Przeniesienie jest idempotentne i degraduje każdego innego właściciela; `org doctor` oznacza tę kontrolę jako `repairable: false` i nie naprawia jej.

Stroną użytkownika końcowego jest tutaj [Własność i przeniesienie](/en/organizations/ownership-and-transfer) — to właśnie przeczytają Twoi użytkownicy, zanim się do Ciebie zwrócą.

## Uzyskiwanie pomocy

* [Repozytorium GitHub](https://github.com/onetimesecret/onetimesecret) — kod źródłowy, informacje o wydaniach i dostarczane stosy Compose.
* [System zgłaszania błędów](https://github.com/onetimesecret/onetimesecret/issues) — błędy, wraz z tagiem wydania i odpowiednimi liniami logów.
* [Skontaktuj się z nami](https://onetimesecret.com/feedback) bezpośrednio w każdej innej sprawie.