Instalacja z Dockerem

To najłatwiejszy sposób uruchomienia NovaDocs na VPS. Docker startuje:

bazę Postgres
aplikację NovaDocs
stosuje schemat bazy
tworzy konto admina (seed)

1. Zainstaluj Dockera

Na Ubuntu:

bash

curl -fsSL https://get.docker.com | sh
sudo usermod -aG docker $USER

Wyloguj się i zaloguj ponownie, żeby zadziałała grupa docker. Sprawdź:

bash

docker --version
docker compose version

2. Pobierz pliki NovaDocs

Pobierz paczkę NovaDocs z BuiltByBit:

https://builtbybit.com/resources/novadocs.120459/

Wgraj zip na serwer (SFTP przez WinSCP / FileZilla), potem rozpakuj. Przykład:

bash

cd /var/www
unzip novadocs-*.zip -d novadocs
cd novadocs

Nazwa folderu może się różnić w zależności od pobranego zipa.

3. Utwórz plik środowiska

bash

cp .env.example .env

Edytuj .env i ustaw co najmniej:

env

AUTH_SECRET="wklej-tu-dlugi-losowy-ciag"
NEXT_PUBLIC_APP_URL="http://IP_TWOJEGO_SERWERA:3000"
SEED_ADMIN_EMAIL="ty@example.com"
SEED_ADMIN_PASSWORD="wybierz-mocne-haslo"
SEED_ADMIN_NAME="Admin"

Wskazówki:

AUTH_SECRET powinien być długi i losowy (np. openssl rand -hex 32)
Gdy podłączysz domenę + HTTPS, zmień NEXT_PUBLIC_APP_URL na https://docs.twojadomena.com

Docker Compose sam ustawia DATABASE_URL do serwisu Postgres. Przy zwykłej instalacji Docker zwykle nie musisz tego zmieniać.

4. Uruchom NovaDocs

bash

docker compose up -d --build

Pierwszy start może potrwać kilka minut (budowa obrazu).

Sprawdź kontenery:

bash

docker compose ps
docker compose logs -f app

Gdy aplikacja wstanie, otwórz:

http://IP_TWOJEGO_SERWERA:3000

Logowanie admina: e-mail i hasło z .env.

Demo docs: /guide/docs/1.0/pl/introduction

5. Przydatne komendy Dockera

bash

# Stop
docker compose down

# Start ponownie
docker compose up -d

# Logi aplikacji
docker compose logs -f app

# Rebuild po aktualizacji (najpierw podmień pliki nowym zipem z BuiltByBit)
docker compose up -d --build

# Ponowny seed (aktualizuje guide / admina)
docker compose exec app npm run db:seed

Domena + HTTPS (opcjonalnie)

Postaw reverse proxy przed portem 3000 (Caddy, Nginx, Traefik lub Cloudflare).

Przykład Caddyfile:

text

docs.twojadomena.com {
  reverse_proxy localhost:3000
}

Potem ustaw:

env

NEXT_PUBLIC_APP_URL="https://docs.twojadomena.com"

Restart:

bash

docker compose up -d

Rozwiązywanie problemów

Aplikacja się restartuje
Uruchom docker compose logs app i szukaj błędów bazy. Poczekaj, aż Postgres będzie healthy, potem: docker compose restart app.

Nie da się zalogować
Sprawdź SEED_ADMIN_EMAIL / SEED_ADMIN_PASSWORD w .env, potem:

bash

docker compose exec app npm run db:seed

Port 3000 jest zajęty
W docker-compose.yml zmień "3000:3000" na "8080:3000" i otwieraj port 8080.