====== 🧠 BASEROW Runbook (Docker + Caddy + SSL) ======

Dokumentacija temelji na realni produkcijski namestitvi Baserow z Dockerjem in Caddy reverse proxyjem.
Vključuje dejanske napake, popravke in preverjene postopke.

===== Namen =====

Ta dokument služi kot:

runbook za ponovno namestitev Baserow

referenca, kje se nahajajo datoteke

vodič za SSL, Caddy in Docker network

osnova za dodajanje novih storitev brez troubleshootinga

===== Lokacija aplikacije =====

Baserow je nameščen v:

<code> /opt/baserow </code>

Struktura:
<code>
/opt/baserow/
docker-compose.yml
data/
</code>

Vse spremembe se izvajajo izključno znotraj te mape.

===== Docker containerji =====

Aktivni containerji:

baserow

postgres

redis (če omogočen)

Preverjanje:
<code>
docker ps
</code>

===== Docker network =====

Baserow mora biti priključen na external network proxy.

V docker-compose.yml:
<code>
networks:
proxy:
external: true
</code>

Razlog:

Caddy uporablja Docker DNS

brez tega reverse proxy ne deluje

Preverjanje:
<code>
docker network inspect proxy
</code>

===== Caddy konfiguracija =====

Caddy je centralni reverse proxy za vse storitve.

Caddyfile se nahaja v:
<code>
/opt/caddy/Caddyfile
</code>

Minimalna konfiguracija za Baserow:
<code>
baserow.krofekhost.com {
reverse_proxy baserow:80
}
</code>

Ponovno nalaganje brez restarta:
<code>
docker exec -it caddy caddy reload --config /etc/caddy/Caddyfile
</code>

===== SSL certifikati =====

SSL certifikate:

izdaja Caddy (Let’s Encrypt)

shranjeni so v Caddy volume

ročna konfiguracija NI potrebna

Preverjanje:
<code>
curl -I https://baserow.krofekhost.com

</code>

===== Kritične environment spremenljivke =====

V docker-compose.yml mora biti pravilno nastavljen:

<code> BASEROW_PUBLIC_URL=https://baserow.krofekhost.com </code>

Če ni pravilno:

login redirecti ne delujejo

API vrača napačne URL-je

===== Incidenti (resnični primeri) =====

==== MultipleObjectsReturned – PasswordAuthProvider ====

Napaka:
<code>
MultipleObjectsReturned: get() returned more than one PasswordAuthProviderModel
</code>

Vzrok:

podvojen auth provider v bazi

upgrade ali broken migration

Rešitev:

Vstop v container:
<code>
docker exec -it baserow bash
</code>

Django shell:
<code>
cd /baserow/backend/src/baserow
/baserow/venv/bin/python manage.py shell
</code>

Popravek:
<code>
from baserow.core.auth_provider.models import PasswordAuthProviderModel
qs = PasswordAuthProviderModel.objects.all().order_by("id")
qs[1:].delete()
</code>

Restart:
<code>
docker restart baserow
</code>

===== Testiranje =====

HTTP test:
<code>
curl -I https://baserow.krofekhost.com

</code>

Funkcionalni test:

prijava

ustvarjanje tabele

API klic

===== Backup =====

Priporočen DB backup:
<code>
docker exec baserow pg_dumpall > /root/backup_baserow.sql
</code>

===== Povzetek =====

ena aplikacija = en docker-compose

vedno proxy network

SSL vedno prek Caddy

auth napake = DB problem

volume briši samo z razlogom