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