Dokumentacija temelji na realni produkcijski postavitvi Activepieces. Vključuje PostgreSQL, Redis, Caddy in obvezne encryption ključe.
Ta dokument omogoča:
stabilen zagon Activepieces
pravilno nastavitev environment spremenljivk
preprečevanje restart loopov
varno dodajanje novih avtomatizacij
/opt/activepieces
Struktura:
/opt/activepieces/ docker-compose.yml data/
activepieces
ap_postgres
ap_redis
Preverjanje:
docker ps
Activepieces mora uporabljati external network proxy.
V docker-compose.yml:
networks: proxy: external: true
Caddyfile lokacija:
/opt/caddy/Caddyfile
Konfiguracija:
activepieces.krofekhost.com {
reverse_proxy activepieces:80
}
Reload:
docker exec -it caddy caddy reload --config /etc/caddy/Caddyfile
OBVEZNO:
geslo v postgres in activepieces mora biti enako
V docker-compose.yml:
POSTGRES_PASSWORD=STRONG_PASSWORD AP_POSTGRES_PASSWORD=STRONG_PASSWORD
Če se ne ujemata:
backend ne bo startal
napaka password authentication failed
Obvezna spremenljivka.
Generiranje:
openssl rand -hex 16
Dodaj v docker-compose.yml:
AP_ENCRYPTION_KEY=32_hex_string
Če manjka:
credentials ne delajo
backend se restartira
Obvezna spremenljivka.
Generiranje:
openssl rand -hex 32
Dodaj:
AP_JWT_SECRET=64_hex_string
Če manjka:
login ne deluje
API vrača napake
Vzrok:
zamenjano ali spremenjeno geslo
stari DB volume
Rešitev (fresh install):
docker volume rm activepieces_ap_pgdata docker compose up -d
Ta ukaz NE vpliva na druge storitve.
Napaka:
AP_ENCRYPTION_KEY is missing or invalid
Rešitev:
generiraj ključ
dodaj v docker-compose.yml
restart container
HTTP:
curl -I https://activepieces.krofekhost.com
UI:
ustvarjanje admin uporabnika
workspace
test flow
Ključe shrani offline:
/root/SECRETS_ACTIVEPIECES.txt
Pravice:
chmod 600 /root/SECRETS_ACTIVEPIECES.txt
Če izgubiš ključe:
izgubiš vse shranjene credentials
encryption ključi so obvezni
DB password mora biti usklajen
SSL vedno prek Caddy
volume reset samo za fresh install
environment spremenljivke so kritične