Hostati Firefly III na Managed VPS-u: vaše financije na vašem poslužitelju

Što radi Firefly III

Firefly III alat je za upravljanje osobnim financijama, namijenjen hostanju na vlastitom poslužitelju. Bilježi vaše troškove i prihode, s budžetima, kategorijama i oznakama, kako biste vidjeli kamo odlazi vaš novac. README ga opisuje kao potpuno samostalno hostan i izoliran: ne kontaktira nijedan vanjski poslužitelj dok mu to izričito ne zatražite.

• Knjigovodstvo: dvojno knjigovodstvo, računi imovine, obveze i bilo koja valuta.
• Automatizacija: ponavljajuće transakcije i pravila koja sami pišete kako bi se svaka transakcija razvrstala.
• Praćenje: budžeti, kasice prasice za štednju prema cilju, izvješća o prihodima i rashodima, grafikoni.
• Sigurnost: dvofaktorska autentifikacija za svaki račun.
• Otvorenost: REST JSON API koji pokriva gotovo cijelu aplikaciju, uz webhookove.

Jedna instanca prima neograničen broj korisnika, a svaki ima financijsku administraciju potpuno odvojenu od ostalih. Dokumentacija opisuje model dijeljenja jedne administracije, koji je trenutačno u razvoju.

Što dopušta licenca AGPL

Firefly III objavljen je pod licencom GNU Affero General Public License, inačica 3 ili, prema vašem izboru, bilo koja kasnija inačica: to je SPDX identifikator AGPL-3.0-or-later u njegovoj datoteci composer.json. Tekst potvrđuje neograničeno dopuštenje za pokretanje neizmijenjenog programa. Stoga možete koristiti sliku koju objavljuje projekt za sebe, svoju obitelj ili svoju tvrtku, bez kupnje licence.

Članak 13. dodaje uvjet svojstven licenci AGPL: ako program izmijenite, vaša inačica mora svima koji je koriste na daljinu, preko mreže, omogućiti da besplatno dobiju njezin izvorni kod. Data Importer, alat za uvoz podataka, objavljen je pod istom licencom.

Instalacija s Docker Composeom

Dokumentacija Docker Compose naziva najjednostavnijim načinom instalacije Firefly III. Na poslužitelju s instaliranim Dockerom izradite mapu i u nju preuzmite tri službene datoteke, u izvornom obliku: razmaci u njima su važni, a dokumentacija traži da ih ne kopirate iz preglednika.

mkdir firefly-iii && cd firefly-iii
curl -o docker-compose.yml https://raw.githubusercontent.com/firefly-iii/docker/main/docker-compose.yml
curl -o .env https://raw.githubusercontent.com/firefly-iii/firefly-iii/main/.env.example
curl -o .db.env https://raw.githubusercontent.com/firefly-iii/docker/main/database.env

• docker-compose.yml opisuje tri usluge: app, aplikaciju, db, bazu MariaDB, i cron, planirani zadatak.
• .env sadrži postavke Firefly III, uključujući ključ za šifriranje i pristup bazi.
• .db.env sadrži postavke baze. Zadržite oba naziva: datoteka Compose poziva ih preko env_file.

Postavke koje treba promijeniti prije prvog pokretanja

Naredbom navedenom u datoteci .env generirajte dva niza od 32 znaka: jedan za ključ, drugi za lozinku baze.

head /dev/urandom | LC_ALL=C tr -dc 'A-Za-z0-9' | head -c 32 && echo

SITE_OWNER=you@example.com
APP_KEY=
DB_PASSWORD=
APP_URL=https://finances.example.com

MYSQL_PASSWORD=

• APP_KEY šifrira vaše sesije. Ima točno 32 znaka, bez posebnih znakova poput =, #, < ili >, a datoteka traži da ga čuvate na vrlo sigurnom mjestu.
• DB_PASSWORD u .env i MYSQL_PASSWORD u .db.env imaju istu vrijednost.
• SITE_OWNER: vaša adresa, prikazana u nekim porukama o pogrešci korisnicima koji nisu administratori.
• APP_URL: javna adresa vaše instance. Datoteka objašnjava da služi za provjeru određenih zahtjeva i za izradu poveznica u porukama e-pošte.
• TZ: vaša vremenska zona, u formatu baze tz, kao u primjeru iz datoteke.

Lozinku baze odaberite prije prvog pokretanja. Baza je sprema u svoj volumen čim nastane: ako je kasnije promijenite, više se ne podudara, a Docker FAQ nudi samo jedan izlaz, uklanjanje kontejnera i volumena te ponovni početak.

Port objavljen lokalno

Službena datoteka objavljuje aplikaciju na portu 80 svih adresa poslužitelja. Da biste je posluživali preko HTTPS-a iza obrnutog proxyja na istom stroju, promijenite ovaj jedan redak u usluzi app:

ports:
  - 127.0.0.1:8080:8080

docker compose -f docker-compose.yml up -d --pull=always
docker compose -f docker-compose.yml logs -f

Pri prvom pokretanju kontejner sam izrađuje i migrira bazu. Kada je instalacija gotova, Firefly III vam u zapisniku zahvaljuje na instalaciji: prijeđite na obrnuti proxy.

• Oznaka latest prati posljednje stabilno izdanje. Oznaka poput version-6.7.9 fiksira inačicu; projekt stare oznake uklanja nakon otprilike šest mjeseci.
• Arhitekture: slike se izrađuju za linux/amd64 i linux/arm64.
• Volumeni: firefly_iii_upload čuva privitke, a firefly_iii_db bazu.

Dokumentacija ne navodi potrebnu memoriju; njezin Docker FAQ predlaže PHP_MEMORY_LIMIT=512M ili više ako PHP-u ponestane memorije. Veličina ovisi o broju korisnika, količini transakcija i alatu za uvoz podataka. Na Managed VPS-u opišite nam svoju upotrebu, a mi vam preporučujemo odgovarajuću veličinu.

HTTPS i obrnuti proxy

Firefly III aplikaciju poslužuje preko HTTP-a na portu 8080 unutar kontejnera, a HTTPS je na obrnutom proxyju ispred njega. Aplikacija čita zaglavlje X-Forwarded-Proto kako bi znala da je posjetitelj stigao preko HTTPS-a, pod uvjetom da vjeruje proxyju:

TRUSTED_PROXIES=*

Docker FAQ o tome je jasan: bez TRUSTED_PROXIES=* poveznice ostaju na http, obrasci i grafikoni prestaju raditi, a sigurnosna zaglavlja CSP ne prolaze. Uz port objavljen na 127.0.0.1 aplikaciju dosiže samo proxy samog poslužitelja. Nakon svake izmjene datoteke .env ponovno izradite kontejner:

docker compose up -d --force-recreate app

S Caddyjem

Caddy sam pribavlja certifikat Let’s Encrypt, a njegova direktiva reverse_proxy prema zadanim postavkama postavlja zaglavlja X-Forwarded-For, X-Forwarded-Proto i X-Forwarded-Host:

finances.example.com {
  reverse_proxy 127.0.0.1:8080
}

S Nginxom i Certbotom

Ovaj blok preuzima zaglavlja iz FAQ-a o instalaciji i međuspremnike koje on predlaže protiv pogrešaka 502 kada aplikacija vraća token u dugom zaglavlju. Sluša na portu 80 kako bi Certbot postavio HTTPS:

server {
    listen 80;
    listen [::]:80;
    server_name finances.example.com;

    client_max_body_size 64M;
    proxy_buffer_size 128k;
    proxy_buffers 4 256k;
    proxy_busy_buffers_size 256k;

    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_set_header X-Forwarded-Host $host;
        proxy_set_header X-Forwarded-Server $host;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_read_timeout 300s;
    }
}

Certbot zatim postavlja certifikat i brine se za njegovu obnovu:

sudo certbot --nginx

• Vlastiti naziv domene: poslužujte Firefly III pod vlastitim nazivom, poput finances.example.com. FAQ napominje da Laravel ne raščlanjuje golu IPv6 adresu u URL-u.
• Pogreške 431: FAQ ih pripisuje premalom ograničenju veličine zaglavlja na proxyju, zbog kojeg neke radnje ne uspijevaju, primjerice prijava.

Prvi račun i registracije

Prvi korisnik koji se registrira postaje vlasnik instance. Iz sigurnosnih razloga registracije se potom same zatvaraju: većina ljudi instalira Firefly III samo za sebe.

1. Otvorite svoju HTTPS adresu čim proxy odgovori i izradite svoj račun: on dobiva ulogu vlasnika.
2. U svojem profilu uključite dvofaktorsku autentifikaciju i sačuvajte osam pričuvnih kodova koje prikazuje.
3. Da biste instancu otvorili drugim osobama, idite na /settings, otvorite konfiguracijske opcije Firefly III, odznačite opciju koja isključuje registracije i spremite.

• Dvofaktorska autentifikacija oslanja se na sat: FAQ navodi da je razlika u vremenu između telefona i poslužitelja onemogućuje.
• Prijava preko vašeg pružatelja identiteta: uz AUTHENTICATION_GUARD=remote_user_guard Firefly III vjeruje autentifikacijskom proxyju postavljenom ispred, poput Authelije ili Authentika, koji korisnika prosljeđuje u zaglavlju.
• Pristupni tokeni: OAuth klijenti i osobni API tokeni izrađuju se iz profila.

Cron zadatak

Nekoliko funkcija radi samo uz planirani zadatak: automatski budžeti, ponavljajuće transakcije, upozorenja o pretplatama i ažurni tečajevi. Docker slika sama ne pokreće cron; službena datoteka za to dodaje malu uslugu cron, koja aplikaciju poziva svaki dan u 3 sata ujutro.

Autentificira se statičnim tokenom. Istom naredbom generirajte treći niz i stavite ga u .env:

STATIC_CRON_TOKEN=

Taj token ima točno 32 znaka: kod inačice 6.7.9 ne prihvaća nijednu drugu duljinu. Evo usluge onako kako je deklarira službena datoteka; dvostruki $$ je namjeran i upućuje na retke TZ i STATIC_CRON_TOKEN datoteke .env:

cron:
  image: alpine
  restart: always
  container_name: firefly_iii_cron
  env_file: .env
  init: true
  command: ["sh", "-c", "apk add tzdata && \
    (ln -s /usr/share/zoneinfo/$$TZ /etc/localtime || true) && \
    echo \"0 3 * * * wget -qO- http://app:8080/api/v1/cron/$$STATIC_CRON_TOKEN;echo\" \
    | crontab - && \
    exec crond -f -L /dev/stdout"]
  networks:
    - firefly_iii
  depends_on:
    - app

Jedan zadatak dovoljan je za sve korisnike instance. Da biste provjerili je li se izvršio, pročitajte zapisnik kontejnera: svaki zadatak izvještava u JSON-u, s job_fired i job_succeeded.

docker logs firefly_iii_cron

Da biste ga pokrenuli ručno, Docker FAQ traži da to učinite kao korisnik www-data, a ne kao root: FAQ tu zamku povezuje s pogreškama dopuštenja na datotekama zapisnika:

docker exec --user www-data firefly_iii_core /usr/local/bin/php /var/www/html/artisan firefly-iii:cron --force

MariaDB, PostgreSQL ili SQLite

Službena datoteka isporučuje MariaDB, sa slikom mariadb:lts. Firefly III podržava i PostgreSQL i SQLite, koje birate s DB_CONNECTION u .env:

DB_CONNECTION=pgsql
DB_HOST=db
DB_PORT=5432

Za PostgreSQL dokumentacija usluzi db dodjeljuje i sliku postgres, koja instalira PostgreSQL 18, te njezin volumen montira na /var/lib/postgresql. U .db.env varijable MYSQL_* postaju POSTGRES_USER, POSTGRES_DB i POSTGRES_PASSWORD.

Ovaj izbor napravite prije unosa prvih transakcija. FAQ navodi da prelazak s jedne baze na drugu ostaje moguć, iako ga sam Firefly III ne podržava, te da izvoz iz aplikacije ne prenosi sve podatke.

Data Importer, alat za uvoz podataka

Firefly III Data Importer zaseban je alat, s vlastitom instalacijom i vlastitim ažuriranjima; njegova inačica 2.3.5 izašla je 23. rujna 2026. Uvozi datoteke CSV i CAMT.053, a može i preuzimati transakcije iz vaših banaka preko vanjskih pružatelja podataka, od kojih svaki ima vlastite uvjete.

Službeni Docker repozitorij isporučuje ga u drugoj datoteci, docker-compose-importer.yml, koja zadržava iste usluge i dodaje importer. Njegove postavke idu u datoteku .importer.env, izrađenu prema datoteci .env.example alata za uvoz. Poslužujte ga pod vlastitim nazivom domene, s portom objavljenim lokalno i drugim blokom proxyja: FAQ traži da ga ne postavljate u poddirektorij.

FIREFLY_III_URL=http://app:8080
VANITY_URL=https://finances.example.com
TRUSTED_PROXIES=*

• FIREFLY_III_URL: interna adresa aplikacije, koju alat za uvoz dosiže preko Docker mreže.
• VANITY_URL: javna adresa Firefly III, ona koju poznaju vaši korisnici.
• OAuth klijent: u svojem profilu Firefly III izradite klijenta čiji je URL za povratni poziv adresa alata za uvoz nakon koje slijedi /callback i odznačite „Confidential”. Alat za uvoz zatim traži njegov ID klijenta.
• Više korisnika: ostavite FIREFLY_III_ACCESS_TOKEN prazan i zadržite FIREFLY_III_URL; svaki se korisnik tada u alat za uvoz prijavljuje vlastitim računom.

E-pošta: SMTP konfiguracija

Prema zadanim postavkama MAIL_MAILER=log poruke upisuje u zapisnike umjesto da ih šalje. Da biste primali obavijesti, poput upozorenja o pretplatama, postavite slanje u .env. Dokumentacija traži da uvijek promijenite MAIL_FROM i SITE_OWNER, inače nijedna poruka e-pošte neće otići.

Na Simafri VPS-u slanje ide preko autentificiranog SMTP releja, na portu 587: adresa računa e-pošte koji već imate ili Simafri Suite.

MAIL_MAILER=smtp
MAIL_HOST=smtp.example.com
MAIL_PORT=587
MAIL_FROM=finances@example.com
MAIL_USERNAME=finances@example.com
MAIL_PASSWORD=account_password
MAIL_ENCRYPTION=tls

• MAIL_ENCRYPTION prihvaća null, ssl, starttls ili tls, ovisno o vašem pružatelju usluge; kod inačice 6.7.9 vraća se na tls kada je vrijednost prazna.
• Test: stranica /settings/notifications šalje probnu poruku e-pošte, nakon što je kontejner ponovno izrađen.
• Drugi kanali: obavijesti mogu ići i na Slack, a na Discord ili Mattermost preko njihova URL-a za webhook nakon kojeg slijedi /slack.

Sigurnosne kopije

Firefly III nema ugrađenu rutinu za sigurnosno kopiranje: dokumentacija preporučuje alate samog sustava i ističe da funkcija izvoza u aplikaciji nije sigurnosna kopija. Uz Docker, evo što treba sačuvati:

Baza, dok usluga radi

Uz MariaDB, mariadb-dump izvozi bazu bez zaustavljanja usluge; njegova opcija --single-transaction daje dosljednu kopiju tablica InnoDB bez njihova zaključavanja. Pokrenuta iz mape s datotekom Compose, naredba pristupne podatke čita iz okruženja kontejnera:

docker exec firefly_iii_db sh -c 'mariadb-dump --single-transaction -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" "$MYSQL_DATABASE"' > firefly-$(date +%F).sql

Uz PostgreSQL ista zamisao ide preko pg_dump:

docker exec firefly_iii_db sh -c 'pg_dump -U "$POSTGRES_USER" "$POSTGRES_DB"' > firefly-$(date +%F).sql

Taj izvoz planirajte na poslužitelju barem jednom dnevno i povremeno prorijedite datoteke, koje se nakupljaju.

Volumeni, uz zaustavljenu uslugu

Dokumentacija svaki volumen arhivira pomoću privremenog kontejnera. Docker Compose nazivima volumena dodaje prefiks s nazivom projekta, a to je prema zadanim postavkama naziv mape: provjerite točne nazive prije pokretanja arhiviranja.

docker volume ls
docker compose stop
docker run --rm -v "firefly-iii_firefly_iii_db:/tmp" -v "$HOME/backups/firefly:/backup" \
    ubuntu tar -czvf /backup/firefly_db.tar /tmp
docker run --rm -v "firefly-iii_firefly_iii_upload:/tmp" -v "$HOME/backups/firefly:/backup" \
    ubuntu tar -czvf /backup/firefly_upload.tar /tmp
docker compose start

Pogrešno napisan naziv volumena ne izaziva pogrešku: Docker pod tim nazivom izrađuje prazan volumen i arhivira ga, čime se prepisuje prethodna sigurnosna kopija. Dokumentacija traži da prije svakog arhiviranja provjerite postoji li volumen.

Čuvajte kopiju datoteke .env i ovih arhiva izvan poslužitelja, šifrirano, jer sadrži ključ i pristupne podatke baze. Postavljene na disk poslužitelja, te datoteke ulaze i u njegove noćne sigurnosne kopije.

Vraćanje

Dokumentacija volumen vraća obrnutom naredbom, uz zaustavljenu uslugu; volumen s privicima vraća se na isti način:

docker run --rm -v "firefly-iii_firefly_iii_db:/recover" -v "$HOME/backups/firefly:/backup" \
    ubuntu tar -xvf /backup/firefly_db.tar -C /recover --strip 1

SQL izvoz ponovno se učitava u bazu dok radi:

docker exec -i firefly_iii_db sh -c 'mariadb -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" "$MYSQL_DATABASE"' < firefly-YYYY-MM-DD.sql

Vratite i datoteku .env s njezinim APP_KEY, a zatim ponovno pokrenite i otvorite svoje račune. Dokumentacija to ponavlja nakon svake metode: prvo što treba učiniti sa sigurnosnom kopijom jest vratiti je, kako biste provjerili da radi.

Ažuriranja i migracije

Firefly III sam se nadograđuje, čak i s inačica starih poput 4.7, te migrira svoju bazu pri pokretanju kontejnera. Dokumentacija upozorava da neke nadogradnje uklanjaju ili čiste podatke i traži sigurnosnu kopiju baze i volumena prije svake od njih, osobito pri prijelazu između glavnih inačica. Iz mape s datotekom Compose:

docker compose stop
docker compose pull
docker compose -f docker-compose.yml up -d --remove-orphans

• Ritam: od inačice 6.7.0 od 14. rujna 2026. do inačice 6.7.9 od 11. listopada 2026. izašlo je deset inačica u četiri tjedna. Pratite bilješke o izdanju: od inačice 6.7.8 prozor u aplikaciji sažima glavne promjene instalirane inačice.
• Inačica 6.7.0 donijela je novo sučelje; njezin mehanizam izraza za pravila prema zadanim je postavkama isključen, a ponovno se uključuje u /settings.
• Datoteka Compose: ako je ponovno preuzmete, provjerite inačicu baze koju deklarira. Dokumentacija upozorava da nova glavna inačica MariaDB-a možda neće preuzeti volumen stare.
• Migracija koja nije uspjela: od inačice 6.4.19 php artisan correction:rollback-single-migration uklanja posljednji unos migracije bez diranja podataka, a zatim je php artisan migrate ponovno pokreće, unutar kontejnera.
• Potpisana izdanja: projekt potpisuje svoja izdanja, što možete provjeriti njegovim PGP ključem.

Alat za uvoz ažurira se na isti način, prema njegovoj dokumentaciji s docker compose rm -f između zaustavljanja i preuzimanja slika.

Tko što radi na Managed VPS-u

Hostanje na vlastitom poslužitelju traži da uz aplikaciju održavate i poslužitelj. Na Managed VPS-u naši timovi preuzimaju poslužitelj i proaktivno prate vašu instancu; Firefly III ostaje vaš softver, sa svojim postavkama i vašim financijskim podacima.

Ako želite da naši timovi interveniraju u samoj aplikaciji, ta se usluga naplaćuje po satu ili paušalno, uz procjenu koja vam se priopćuje prije intervencije.