vitrinkaDokumentaceZpět do vitrínky

Instalace na vlastní server

Jeden Go binárník, jeden kontejner, vaše infrastruktura. Self-hosted balík nainstaluje vitrinku na jeden stroj přes Docker Compose — a to je schválně jediná podporovaná topologie.

Podporovaný tvar

Compose na jednom stroji, váš reverzní proxy na TLS, disk nebo vaše S3 na blob soubory, váš identity provider na SSO. Za hranicí jednoho stroje je odpovědí spravovaná instance, ne škálovat tohle vlastními silami — ta hranice je záměrná, ne opomenutí.

Instalace

Dvě povinné hodnoty a spustit. Binárník si při startu migruje schéma sám.

cp .env.example .env
# uprav .env: BASE_URL a VITRINKA_MASTER_KEY
openssl rand -hex 32      # vygeneruje master key

docker compose up -d

Postavte před to proxy

Váš reverzní proxy terminuje TLS a přeposílá na publikovaný port (výchozí 8080). BASE_URL musí být veřejná adresa, na kterou uživatelé opravdu chodí. Aplikace TLS neterminuje nikdy sama.

BASE_URL musí být v produkci https, jinak session cookies ztratí příznak Secure. Server na to při startu hlasitě upozorní.

První administrátor

Prvním vlastníkem se stane první účet, který se zaregistruje. Pokud zapínáte vynucené SSO, založte ho rovnou přes svůj identity provider.

Žádný migrační krok

Schéma se migruje samo při startu. První spuštění vytvoří všechno, upgrade dohraje, co chybí. Každé vydání migruje z libovolného předchozího — nejsou žádné tvrdé zarážky.

Dimenzování

Hostitel kontejnerů, který zvládne jeden image a jeden volume, volume pro /data a něco, co terminuje TLS. Volitelně S3 kompatibilní bucket, pokud nechcete blob soubory na disku.

Konkrétní CPU, RAM a disk tu schválně nejsou: podporovaná topologie publikovaná je, dimenzování ne, a vymyslet si číslo by bylo horší než ho neuvést. Ozvěte se a nadimenzujeme to podle objemu vašich session.