Näin hostaatte Firefly III:n Managed VPS:llä: taloutenne omalla palvelimellanne

Mitä Firefly III tekee

Firefly III on henkilökohtaisen talouden hallintaohjelma, joka on tehty omaan hostaukseen. Se seuraa menojanne ja tulojanne budjettien, luokkien ja tunnisteiden avulla, jotta näette, mihin rahanne menevät. Sen README kuvaa sen täysin omalla palvelimella toimivaksi ja eristetyksi: se ei ota yhteyttä mihinkään ulkoiseen palvelimeen, ennen kuin pyydätte sitä nimenomaisesti.

• Kirjanpito: kahdenkertainen kirjanpito, omaisuustilit, velat ja mikä tahansa valuutta.
• Automaatio: toistuvat tapahtumat sekä itse kirjoitettavat säännöt, jotka luokittelevat jokaisen tapahtuman.
• Seuranta: budjetit, säästöpossut tavoitteeseen säästämiseen, tulo- ja menoraportit sekä kaaviot.
• Tietoturva: kaksivaiheinen tunnistautuminen jokaiselle tilille.
• Avoimuus: REST JSON -rajapinta, joka kattaa lähes koko sovelluksen, sekä webhookit.

Yksi instanssi voi palvella niin montaa käyttäjää kuin haluatte, ja jokaisella on oma, muista täysin erillinen taloushallintonsa. Dokumentaatio kuvaa myös mallin yhden taloushallinnon jakamiseen, ja se on parhaillaan kehitteillä.

Mitä AGPL-lisenssi sallii

Firefly III julkaistaan GNU Affero General Public License, versio 3 tai valintanne mukaan mikä tahansa myöhempi versio -lisenssillä: tämä on SPDX-tunniste AGPL-3.0-or-later sen tiedostossa composer.json. Teksti vahvistaa rajoittamattoman luvan ajaa muokkaamatonta ohjelmaa. Voitte siis käyttää projektin julkaisemaa imagea itsellenne, perheellenne tai yrityksellenne ilman ostettavaa lisenssiä.

Pykälä 13 lisää AGPL:lle ominaisen ehdon: jos muokkaatte ohjelmaa, versionne on tarjottava kaikille, jotka käyttävät sitä etäyhteydellä verkon kautta, keino saada sen lähdekoodi maksutta. Data Importer -tuontityökalu on saman lisenssin alainen.

Asennus Docker Composella

Dokumentaation mukaan Docker Compose on helpoin tapa asentaa Firefly III. Luokaa palvelimelle, jolle Docker on asennettu, kansio ja ladatkaa sinne kolme virallista tiedostoa sellaisinaan: niiden välistys on merkitsevä, ja dokumentaatio pyytää olemaan kopioimatta niitä selaimesta.

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 kuvaa kolme palvelua: app eli sovellus, db eli MariaDB-tietokanta ja cron eli ajastettu tehtävä.
• .env sisältää Firefly III:n asetukset, muun muassa salausavaimen ja tietokantayhteyden.
• .db.env sisältää tietokannan asetukset. Säilyttäkää molemmat nimet: Compose-tiedosto viittaa niihin avaimella env_file.

Ennen ensimmäistä käynnistystä muutettavat asetukset

Luokaa kaksi 32 merkin merkkijonoa tiedostossa .env annetulla komennolla: toinen avaimeksi, toinen tietokannan salasanaksi.

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 salaa istuntonne. Se on täsmälleen 32 merkkiä pitkä, ilman erikoismerkkejä kuten =, #, < tai >, ja tiedosto pyytää säilyttämään sen hyvin turvassa.
• DB_PASSWORD tiedostossa .env ja MYSQL_PASSWORD tiedostossa .db.env saavat saman arvon.
• SITE_OWNER: osoitteenne, joka näytetään joissakin virheilmoituksissa käyttäjille, jotka eivät ole ylläpitäjiä.
• APP_URL: instanssinne julkinen osoite. Tiedosto kertoo, että sitä käytetään tiettyjen pyyntöjen validointiin ja sähköpostien linkkien muodostamiseen.
• TZ: aikavyöhykkeenne tz-tietokannan muodossa, kuten tiedoston esimerkki näyttää.

Valitkaa tietokannan salasana ennen ensimmäistä käynnistystä. Tietokanta tallentaa sen taltioonsa heti luonnin yhteydessä: jos vaihdatte sen myöhemmin, se ei enää täsmää, ja Dockerin usein kysytyt kysymykset tarjoavat vain yhden ratkaisun, eli konttien ja taltioiden poistamisen ja alusta aloittamisen.

Paikallisesti julkaistu portti

Virallinen tiedosto julkaisee sovelluksen palvelimen kaikkien osoitteiden portissa 80. Jotta voitte tarjota sen HTTPS:llä samalla koneella olevan käänteisen välityspalvelimen takana, muuttakaa app-palvelussa tämä yksi rivi:

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

Ensimmäisellä käynnistyskerralla kontti luo ja migroi tietokannan itse. Kun asennus on valmis, Firefly III kiittää lokissa asennuksesta: siirtykää käänteiseen välityspalvelimeen.

• Tunniste latest seuraa uusinta vakaata versiota. Tunniste, kuten version-6.7.9, kiinnittää version; projekti poistaa vanhat tunnisteet noin kuuden kuukauden kuluttua.
• Arkkitehtuurit: imaget käännetään alustoille linux/amd64 ja linux/arm64.
• Taltiot: firefly_iii_upload säilyttää liitteet, firefly_iii_db tietokannan.

Dokumentaatio ei ilmoita muistin tarvetta; sen Docker-kysymykset ehdottavat asetusta PHP_MEMORY_LIMIT=512M tai enemmän, jos PHP:ltä loppuu muisti. Koko riippuu käyttäjien määrästä, tapahtumien määrästä ja tuontityökalun käytöstä. Managed VPS -palvelimella kertokaa meille käyttötarkoituksenne, niin suosittelemme sopivaa kokoa.

HTTPS ja käänteinen välityspalvelin

Firefly III tarjoaa sovelluksen HTTP:llä kontin sisällä portissa 8080, ja HTTPS hoidetaan sen edessä olevalla käänteisellä välityspalvelimella. Sovellus lukee otsakkeen X-Forwarded-Proto tietääkseen, että kävijä saapui HTTPS:llä, kunhan se luottaa välityspalvelimeen:

TRUSTED_PROXIES=*

Dockerin usein kysytyt kysymykset ovat tässä selviä: ilman asetusta TRUSTED_PROXIES=* linkit jäävät http-muotoon, lomakkeet ja kaaviot lakkaavat toimimasta ja CSP-tietoturvaotsakkeet epäonnistuvat. Kun portti on julkaistu osoitteessa 127.0.0.1, sovellukseen pääsee vain palvelimen oma välityspalvelin. Luokaa kontti uudelleen jokaisen .env-tiedoston muutoksen jälkeen:

docker compose up -d --force-recreate app

Caddyllä

Caddy hankkii Let’s Encrypt -varmenteen itse, ja sen reverse_proxy-direktiivi asettaa oletuksena otsakkeet X-Forwarded-For, X-Forwarded-Proto ja X-Forwarded-Host:

finances.example.com {
  reverse_proxy 127.0.0.1:8080
}

Nginxillä ja Certbotilla

Tämä lohko noudattaa asennuksen usein kysyttyjen kysymysten otsakkeita sekä niiden ehdottamia puskureita 502-virheitä vastaan, kun sovellus palauttaa tunnuksen pitkässä otsakkeessa. Se kuuntelee porttia 80, jotta Certbot voi asentaa HTTPS:n:

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 asentaa sen jälkeen varmenteen ja huolehtii sen uusimisesta:

sudo certbot --nginx

• Oma verkkotunnus: tarjotkaa Firefly III omalla nimellään, kuten finances.example.com. Usein kysytyt kysymykset huomauttavat, että Laravel ei jäsennä osoitteessa olevaa paljasta IPv6-osoitetta.
• 431-virheet: usein kysytyt kysymykset jäljittävät ne välityspalvelimen liian pieneen otsakkeiden kokorajaan, joka saa jotkin toiminnot, kuten kirjautumisen, epäonnistumaan.

Ensimmäinen tili ja rekisteröityminen

Ensimmäisenä rekisteröityvästä käyttäjästä tulee instanssin omistaja. Turvallisuussyistä rekisteröityminen sulkeutuu sen jälkeen itsestään: useimmat asentavat Firefly III:n vain itselleen.

1. Avatkaa HTTPS-osoitteenne heti, kun välityspalvelin vastaa, ja luokaa tilinne: se saa omistajan roolin.
2. Ottakaa profiilissanne käyttöön kaksivaiheinen tunnistautuminen ja säilyttäkää sen näyttämät kahdeksan varakoodia.
3. Avataksenne instanssin muille siirtykää osoitteeseen /settings, avatkaa Firefly III:n määritysvalinnat, poistakaa rasti rekisteröitymisen estävästä valinnasta ja tallentakaa.

• Kaksivaiheinen tunnistautuminen perustuu kelloon: usein kysytyt kysymykset kertovat, että puhelimen ja palvelimen välinen aikaero saa sen epäonnistumaan.
• Kirjautuminen oman tunnistuspalvelunne kautta: asetuksella AUTHENTICATION_GUARD=remote_user_guard Firefly III luottaa eteen asetettuun todennusvälityspalvelimeen, kuten Autheliaan tai Authentikiin, joka välittää käyttäjän otsakkeessa.
• Käyttötunnukset: OAuth-asiakkaat ja henkilökohtaiset API-tunnukset luodaan profiilista.

Ajastettu cron-tehtävä

Useat toiminnot toimivat vain ajastetun tehtävän kanssa: automaattiset budjetit, toistuvat tapahtumat, tilausten muistutukset ja ajantasaiset valuuttakurssit. Docker-image ei aja cronia itse; virallinen tiedosto lisää tähän tarkoitukseen pienen cron-palvelun, joka kutsuu sovellusta joka päivä kello 3.

Se todentaa itsensä staattisella tunnuksella. Luokaa samalla komennolla kolmas merkkijono ja sijoittakaa se tiedostoon .env:

STATIC_CRON_TOKEN=

Tämä tunnus on täsmälleen 32 merkkiä pitkä: version 6.7.9 koodi ei hyväksy muuta pituutta. Tässä on palvelu sellaisena kuin virallinen tiedosto sen määrittää; kaksinkertainen $$ on tarkoituksellinen ja viittaa .env-tiedoston riveihin TZ ja STATIC_CRON_TOKEN:

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

Yksi tehtävä riittää instanssin kaikille käyttäjille. Tarkistaaksenne, että se on ajettu, lukekaa kontin loki: jokainen tehtävä raportoi JSON-muodossa kentillä job_fired ja job_succeeded.

docker logs firefly_iii_cron

Käsin ajettaessa Dockerin usein kysytyt kysymykset pyytävät käyttämään käyttäjää www-data eikä root: ne yhdistävät tämän sudenkuopan lokitiedostojen käyttöoikeusvirheisiin:

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

MariaDB, PostgreSQL vai SQLite

Virallinen tiedosto toimittaa MariaDB:n imagella mariadb:lts. Firefly III tukee myös PostgreSQL:ää ja SQLiteä, jotka valitaan muuttujalla DB_CONNECTION tiedostossa .env:

DB_CONNECTION=pgsql
DB_HOST=db
DB_PORT=5432

PostgreSQL:ää varten dokumentaatio vaihtaa myös db-palvelun imageksi postgres, joka asentaa PostgreSQL 18:n, ja liittää sen taltion polkuun /var/lib/postgresql. Tiedostossa .db.env MYSQL_*-muuttujista tulee POSTGRES_USER, POSTGRES_DB ja POSTGRES_PASSWORD.

Tehkää tämä valinta ennen ensimmäisten tapahtumienne kirjaamista. Usein kysyttyjen kysymysten mukaan siirtyminen tietokannasta toiseen on mahdollista, vaikka Firefly III ei itse tue sitä, eikä sovelluksen vienti sisällä kaikkia tietoja.

Data Importer -tuontityökalu

Firefly III Data Importer on erillinen työkalu, jolla on oma asennuksensa ja omat päivityksensä; sen versio 2.3.5 julkaistiin 23. syyskuuta 2026. Se tuo CSV- ja CAMT.053-tiedostoja ja voi myös hakea tapahtumat pankeistanne kolmannen osapuolen tietopalvelujen kautta, joilla kullakin on omat ehtonsa.

Virallinen Docker-repositorio toimittaa sen toisessa tiedostossa, docker-compose-importer.yml, joka säilyttää samat palvelut ja lisää palvelun importer. Sen asetukset sijoitetaan tiedostoon .importer.env, joka pohjautuu tuontityökalun tiedostoon .env.example. Tarjotkaa se omalla verkkotunnuksellaan, paikallisesti julkaistulla portilla ja toisella välityspalvelinlohkolla: usein kysytyt kysymykset pyytävät olemaan sijoittamatta sitä alihakemistoon.

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

• FIREFLY_III_URL: sovelluksen sisäinen osoite, johon tuontityökalu yhdistää Docker-verkon kautta.
• VANITY_URL: Firefly III:n julkinen osoite, jonka käyttäjänne tuntevat.
• OAuth-asiakas: luokaa Firefly III -profiilissanne asiakas, jonka paluuosoite on tuontityökalun osoite ja sen perässä /callback, ja poistakaa rasti kohdasta ”Confidential”. Tuontityökalu kysyy sen jälkeen asiakkaan tunnistetta.
• Useita käyttäjiä: jättäkää FIREFLY_III_ACCESS_TOKEN tyhjäksi ja säilyttäkää FIREFLY_III_URL; kukin käyttäjä kirjautuu silloin tuontityökaluun omalla tilillään.

Sähköpostit: SMTP-määritys

Oletuksena MAIL_MAILER=log kirjoittaa viestit lokeihin lähettämisen sijaan. Saadaksenne ilmoituksia, kuten tilausten muistutuksia, määrittäkää lähetys tiedostossa .env. Dokumentaatio pyytää aina muuttamaan arvot MAIL_FROM ja SITE_OWNER, muuten yhtään sähköpostia ei lähde.

Simafrin VPS:llä lähetys kulkee todennetun SMTP-releen kautta portissa 587: käyttöön sopii jo omistamanne sähköpostitilin osoite tai 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 hyväksyy arvot null, ssl, starttls tai tls palveluntarjoajanne mukaan; version 6.7.9 koodi käyttää arvoa tls, kun arvo on tyhjä.
• Kokeilu: sivu /settings/notifications lähettää testisähköpostin, kun kontti on luotu uudelleen.
• Muut kanavat: ilmoitukset voivat mennä myös Slackiin sekä Discordiin tai Mattermostiin niiden webhook-osoitteen kautta, jonka perään lisätään /slack.

Varmuuskopiot

Firefly III:ssa ei ole sisäänrakennettua varmuuskopiointia: dokumentaatio suosittelee järjestelmän omia työkaluja ja huomauttaa, ettei sovelluksen vientitoiminto ole varmuuskopio. Dockerilla säilytettävät osat ovat nämä:

Tietokanta palvelun ollessa käynnissä

MariaDB:llä mariadb-dump vie tietokannan pysäyttämättä palvelua; sen valinta --single-transaction antaa yhtenäisen kopion InnoDB-tauluista lukitsematta niitä. Compose-tiedoston kansiossa ajettuna komento lukee tunnukset kontin ympäristöstä:

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

PostgreSQL:llä sama ajatus toteutetaan komennolla pg_dump:

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

Ajastakaa tämä vienti palvelimella vähintään kerran päivässä ja karsikaa tiedostoja, jotka kasautuvat.

Taltiot palvelun ollessa pysäytettynä

Dokumentaatio arkistoi jokaisen taltion kertakäyttöisellä kontilla. Docker Compose lisää taltioiden nimien eteen projektin nimen, joka on oletuksena kansion nimi: tarkistakaa tarkat nimet ennen arkistoinnin ajamista.

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

Väärin kirjoitettu taltion nimi ei aiheuta virhettä: Docker luo sillä nimellä tyhjän taltion ja arkistoi sen, mikä korvaa edellisen varmuuskopion. Dokumentaatio pyytää tarkistamaan taltion olemassaolon ennen jokaista arkistointia.

Säilyttäkää kopio tiedostosta .env ja näistä arkistoista palvelimen ulkopuolella salattuna, koska se sisältää avaimen ja tietokannan tunnukset. Palvelimen levylle sijoitettuina nämä tiedostot päätyvät myös sen yöllisiin varmuuskopioihin.

Palauttaminen

Dokumentaatio palauttaa taltion käänteisellä komennolla palvelun ollessa pysäytettynä; liitteiden taltio palautetaan samalla tavalla:

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-vienti ladataan takaisin käynnissä olevaan tietokantaan:

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

Palauttakaa myös .env ja sen APP_KEY, käynnistäkää uudelleen ja avatkaa tilinne. Dokumentaatio toistaa sen jokaisen menetelmän jälkeen: varmuuskopiolla tehdään ensimmäiseksi palautus, jotta näette sen toimivan.

Päivitykset ja migraatiot

Firefly III päivittyy itse, jopa niinkin vanhoista versioista kuin 4.7, ja migroi tietokantansa kontin käynnistyessä. Dokumentaatio varoittaa, että jotkin päivitykset poistavat tai siivoavat tietoja, ja pyytää varmuuskopioimaan tietokannan ja taltiot ennen jokaista päivitystä, etenkin pääversioiden välillä. Compose-tiedoston kansiossa:

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

• Tahti: versiosta 6.7.0, 14. syyskuuta 2026, versioon 6.7.9, 11. lokakuuta 2026, julkaistiin kymmenen versiota neljässä viikossa. Seuratkaa julkaisutietoja: versiosta 6.7.8 alkaen sovelluksen ikkuna tiivistää asennetun version tärkeimmät muutokset.
• Versio 6.7.0 toi uuden käyttöliittymän; sen sääntölausekkeiden moottori on oletuksena pois käytöstä, ja se otetaan uudelleen käyttöön osoitteessa /settings.
• Compose-tiedosto: jos lataatte sen uudelleen, tarkistakaa sen ilmoittama tietokannan versio. Dokumentaatio varoittaa, että MariaDB:n uusi pääversio ei välttämättä ota käyttöön vanhan version taltiota.
• Migraatio, joka ei onnistunut: versiosta 6.4.19 alkaen php artisan correction:rollback-single-migration poistaa viimeisimmän migraatiomerkinnän koskematta tietoihin, minkä jälkeen php artisan migrate ajaa sen uudelleen, kontin sisällä.
• Allekirjoitetut julkaisut: projekti allekirjoittaa julkaisunsa, ja ne voi tarkistaa sen PGP-avaimella.

Tuontityökalu päivitetään samalla tavalla, sen dokumentaation mukaan komennolla docker compose rm -f pysäytyksen ja imagejen hakemisen välissä.

Kuka tekee mitä Managed VPS:llä

Oma hostaus vaatii palvelimen ylläpitoa sovelluksen lisäksi. Managed VPS -palvelimella tiimimme huolehtivat palvelimesta ja seuraavat instanssianne proaktiivisesti; Firefly III pysyy teidän ohjelmananne asetuksineen ja taloustietoineen.

Jos haluatte tiimiemme toimivan itse sovelluksessa, tämä palvelu laskutetaan tuntiveloituksella tai kiinteällä hinnalla, ja arvio annetaan ennen toimenpidettä.