Firefly III Nedir ve Kişisel Finans Yönetimi Kurulumu

Ay sonu geldiğinde "paramın nereye gittiğini anlayamıyorum" diyorsanız, sorun çoğu zaman kazancınızda değil, harcamalarınızı görünür kılamamanızdadır. Banka uygulamaları size bakiyeyi gösterir ama hikâyeyi anlatmaz: Hangi kategoriye ne kadar gitti, market harcaması geçen aya göre arttı mı, abonelikler toplamda ne tutuyor? Bu soruların cevabını düzenli olarak görmek, tasarruf etmenin ilk ve en önemli adımıdır. Firefly III, tam da bunun için tasarlanmış, açık kaynaklı bir kişisel finans yönetimi aracıdır.

Bu makalede Firefly III'ün ne olduğunu, hesap ve kategori mantığını, bütçe ve kural sistemini nasıl kurguladığını inceleyeceğiz. Ardından Docker Compose ile pratik bir kurulum yapacak, işlemlerin nasıl girildiğine ve banka verilerinin içe aktarma araçlarıyla nasıl otomatik çekildiğine bakacağız. Son olarak raporlar ve grafikler üzerinden verinizin size ne söylediğini anlamlandıracak, aracı kendi sunucunuzda barındırmanın neden mantıklı olduğunu değerlendireceğiz.

Firefly III Nedir ve Ne İşe Yarar?#

Firefly III, gelirlerinizi, giderlerinizi, hesaplarınızı ve bütçelerinizi tek bir yerde toplayan, web tabanlı bir kişisel finans yöneticisidir. Onu bir "kişisel muhasebe defteri" gibi düşünebilirsiniz: Her para hareketini kaydeder, sınıflandırır ve zaman içindeki eğilimleri size grafiklerle gösterir. En önemli özelliği, tüm bu verinin sizin kontrolünüzde olmasıdır; hiçbir para hareketi üçüncü bir şirketin bulutuna gitmez.

Aracın temelinde çift girişli muhasebe (double-entry accounting) mantığı yatar. Bu kulağa teknik gelse de pratikte çok basittir: Para hiçbir zaman yoktan var olmaz veya buharlaşmaz, mutlaka bir yerden çıkıp bir yere gider. Marketten 500 lira harcadığınızda, bu para banka hesabınızdan çıkıp "Market" adlı bir gider hesabına akar. Maaşınız yattığında, işvereninizi temsil eden bir gelir hesabından çıkıp maaş hesabınıza girer. Bu yaklaşım, kayıtlarınızın her zaman tutarlı olmasını sağlar; "kayıp para" diye bir şey olamaz, her kuruşun bir kaynağı ve hedefi vardır.

Firefly III üç temel işlem türüyle çalışır. Harcama (withdrawal) paranın bir varlık hesabından bir gider hesabına gitmesidir. Gelir (deposit) paranın bir gelir kaynağından varlık hesabınıza girmesidir. Transfer ise kendi hesaplarınız arasındaki para hareketidir; örneğin vadesiz hesaptan tasarruf hesabına aktardığınız para ne gelirdir ne de gider, sadece yer değiştirir. Bu ayrım, raporlarınızın doğru çıkması için kritiktir.

Hesaplar, Kategoriler ve Etiketler#

Firefly III'te her şey hesaplar üzerine kuruludur ve dört tür hesap vardır. Bunları doğru kavramak, aracı verimli kullanmanın anahtarıdır.

Kurulumdan sonra atılacak ilk adım, kendi varlık hesaplarınızı tanımlamaktır. Vadesiz banka hesabınız, kredi kartınız, nakit paranız için birer hesap oluşturur ve başlangıç bakiyelerini girersiniz. Gider ve gelir hesaplarını önceden tek tek oluşturmanıza gerek yoktur; ilk işlemi girerken yeni bir gider hesabı adı yazdığınızda Firefly III onu otomatik oluşturur.

Hesapların yanında iki sınıflandırma katmanı daha vardır. Kategoriler harcamanın türünü belirtir (örneğin "Gıda", "Ulaşım", "Eğlence") ve raporlarda en çok işe yarayan alandır. Etiketler (tags) ise kategoriden bağımsız, çapraz gruplamalar yapmanızı sağlar; örneğin "Yaz Tatili 2026" etiketini farklı kategorilerdeki (ulaşım, konaklama, yemek) işlemlere ekleyerek tek bir gezinin toplam maliyetini görebilirsiniz. Kategori "ne tür harcama" sorusuna, etiket "hangi bağlamda" sorusuna cevap verir; ikisini birlikte kullanmak analizinizi güçlendirir.

Bütçeler ve Faturalarla Harcama Kontrolü#

Verinizi kaydetmek tek başına disiplin getirmez; asıl güç, sınır koyabilmekte yatar. Firefly III bunu iki mekanizmayla sağlar: bütçeler ve faturalar.

Bütçeler (budgets) belirli bir kategori grubu için aylık harcama limiti koymanızı sağlar. Örneğin "Market" bütçesine ayda 6.000 lira ayırdığınızda, ay ilerledikçe Firefly III size ne kadarını harcadığınızı yüzde ve çubuk grafikle gösterir. Limiti aşmaya yaklaştığınızda çubuk kırmızıya döner, aştığınızda ise fazlayı net görürsünüz. Bu, "farkında olmadan aşma" problemini büyük ölçüde çözer. Bütçeleri aylık, haftalık ya da yıllık aralıklarla tekrar eden şekilde kurabilirsiniz.

Faturalar (bills) ise düzenli tekrar eden ödemeleri takip eder: kira, internet, telefon, hosting ve alan adı yenilemeleri, dijital abonelikler. Bir fatura tanımladığınızda beklenen tutarı ve tekrar aralığını (örneğin her ayın 5'i) belirtirsiniz. Firefly III, gelen işlemleri bu faturalarla otomatik eşleştirir ve size "bu ay hangi düzenli ödemeler yapıldı, hangileri bekleniyor" özetini sunar. Böylece bir ödemeyi unuttuğunuzda ya da bir abonelik zamlandığında hemen fark edersiniz.

İkisini birlikte kullandığınızda güçlü bir tablo oluşur: Faturalar sabit giderlerinizi öngörülebilir kılar, bütçeler ise değişken harcamalarınızı sınırlar. Ay başında "sabit giderler şu kadar, geri kalanı şu kategorilere şu limitlerle dağıtıyorum" diyebilir ve ay boyunca bu plana ne kadar sadık kaldığınızı somut olarak izleyebilirsiniz.

Kurallar Sistemi ile Otomatik Sınıflandırma#

Firefly III'ün en çok zaman kazandıran özelliği kurallar (rules) motorudur. Her işlemi elle kategorize etmek, uzun vadede yorucu ve sürdürülemez hâle gelir. Kurallar, bu işi sizin yerinize yapar.

Bir kural iki parçadan oluşur: tetikleyiciler (triggers) ve eylemler (actions). Tetikleyiciler bir işlemin kurala uyup uymadığını belirler; örneğin "açıklama 'MIGROS' içeriyorsa" veya "tutar 100 liradan büyükse". Eylemler ise koşul sağlandığında ne yapılacağını söyler; örneğin "kategoriyi 'Gıda' yap", "bütçeyi 'Market' olarak ata" veya "'düzenli-alışveriş' etiketini ekle".

Diyelim ki her maaş yatışında bir kısmını tasarrufa ayırmayı unutuyorsunuz ya da kart ekstresindeki market harcamalarını sürekli elle etiketliyorsunuz. Şöyle bir kural bu yükü tamamen kaldırır:

Kural: Market harcamalarını otomatik sınıflandır
Tetikleyici:  Açıklama içerir "MIGROS"
Tetikleyici:  VEYA açıklama içerir "CARREFOUR"
Eylem:        Kategoriyi ayarla -> Gıda
Eylem:        Bütçeyi ayarla    -> Market
Eylem:        Etiket ekle       -> düzenli-alışveriş

Kuralları gruplar hâlinde düzenleyebilir ve sıralamalarını belirleyebilirsiniz; üsttekiler önce çalışır. Ayrıca kuralları yalnızca yeni işlemlere değil, mevcut geçmiş işlemlerinize de toplu olarak uygulayabilirsiniz. Bu, özellikle banka verilerini içe aktardıktan sonra yüzlerce işlemi tek seferde temizlemek için paha biçilmezdir. İyi kurgulanmış bir kural seti, aylık finans bakımınızı yarım saatlik bir işten birkaç dakikalık bir kontrole indirir.

Docker Compose ile Kurulum#

Firefly III'ü çalıştırmanın en temiz yolu Docker Compose'dur; tüm bileşenleri (uygulama, veritabanı, veri içe aktarıcı) tek bir yapılandırma dosyasında toplar. Sunucunuzda Docker ve Docker Compose kurulu olduğunu varsayarak başlayalım. Önce hassas ayarları tutacak bir .env dosyası oluşturun:

# .env — Firefly III temel ayarları
APP_KEY=Buraya32KarakterlikRastgeleAnahtar
DB_HOST=db
DB_PORT=3306
DB_CONNECTION=mysql
DB_DATABASE=firefly
DB_USERNAME=firefly
DB_PASSWORD=guclu-bir-veritabani-parolasi
APP_URL=https://finans.ornekalanadi.com
TZ=Europe/Istanbul
TRUSTED_PROXIES=**

APP_KEY tam olarak 32 karakter olmalıdır; güvenli bir değer üretmek için şu komutu kullanabilirsiniz:

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

Ardından servisleri tanımlayan docker-compose.yml dosyasını hazırlayın. Aşağıdaki yapı; uygulamayı, bir MariaDB veritabanını ve resmi veri içe aktarma aracını birlikte ayağa kaldırır:

services:
  app:
    image: fireflyiii/core:latest
    restart: always
    env_file: .env
    volumes:
      - firefly_upload:/var/www/html/storage/upload
    ports:
      - "8080:8080"
    depends_on:
      - db

  db:
    image: mariadb:11
    restart: always
    environment:
      MYSQL_RANDOM_ROOT_PASSWORD: "yes"
      MYSQL_DATABASE: firefly
      MYSQL_USER: firefly
      MYSQL_PASSWORD: guclu-bir-veritabani-parolasi
    volumes:
      - firefly_db:/var/lib/mysql

  importer:
    image: fireflyiii/data-importer:latest
    restart: always
    environment:
      FIREFLY_III_URL: http://app:8080
      VANITY_URL: https://finans.ornekalanadi.com
    ports:
      - "8081:8080"
    depends_on:
      - app

volumes:
  firefly_db:
  firefly_upload:

Dosyaları hazırladıktan sonra tek komutla her şeyi başlatırsınız:

docker compose up -d

Uygulama 8080 portunda ayağa kalkar. İlk açılışta bir hesap oluşturur ve yönetici olursunuz. Gerçek bir kullanımda uygulamayı doğrudan porttan açmak yerine önüne bir ters proxy koyup HTTPS ile yayınlamak gerekir. Nginx tarafında sade bir yapılandırma şöyle görünür:

server {
    listen 443 ssl;
    server_name finans.ornekalanadi.com;

    ssl_certificate     /etc/letsencrypt/live/finans.ornekalanadi.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/finans.ornekalanadi.com/privkey.pem;

    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-Proto https;
        proxy_set_header X-Forwarded-For $remote_addr;
    }
}

Ücretsiz sertifika için Let's Encrypt tabanlı SSL çözümlerimizden yararlanabilirsiniz. Bu kurulumun sorunsuz çalışması için sunucunuzun yeterli belleğe sahip olması yeterlidir; Firefly III mütevazı kaynaklarla bir sanal sunucu üzerinde rahatça koşar. Kişisel verilerinizi tutan bu tür bir uygulamayı barındırırken düzenli yedekleme almayı da ihmal etmeyin.

İşlem Girişi ve Banka İçe Aktarma Araçları#

Firefly III'e veri girmenin iki yolu vardır: elle giriş ve otomatik içe aktarma. Günlük kullanımda ikisi bir arada yürür.

Elle giriş, arayüzdeki basit bir formla yapılır. İşlem türünü (harcama, gelir, transfer) seçer; kaynak ve hedef hesabı, tutarı, tarihi ve açıklamayı girersiniz. Nakit harcamalar ve kaydı otomatik gelmeyen küçük ödemeler için bu yöntem pratiktir. Ayrıca fatura fişinin fotoğrafını işleme ekleyebildiğiniz için, ileride bir harcamayı belgelemek gerektiğinde her şey tek yerde durur.

Asıl güç, banka verilerini içe aktarmakta yatar. Firefly III bunu ayrı bir bileşen olan Firefly III Data Importer ile yapar (yukarıdaki Compose dosyasında importer servisi olarak zaten tanımlıydı). Bu araç birkaç farklı kaynağı destekler:

• CSV dosyası: Bankanızın internet şubesinden indirdiğiniz hesap hareketleri dökümünü içe aktarabilirsiniz. Sütun eşleştirmesini bir kez ayarlar (hangi sütun tarih, hangisi tutar, hangisi açıklama), bu şablonu kaydeder ve sonraki dökümleri aynı ayarla hızlıca yüklersiniz.
• camt.053 / MT940: Bankacılık standardı formatlarında dışa aktarma yapabilen kurumsal hesaplar için.
• GoCardless ve SimpleFIN: Açık bankacılık (open banking) bağlantıları üzerinden, destekleyen bankalardan işlemleri doğrudan çekmenizi sağlar. Bu sayede her ay elle CSV indirmek yerine bağlantıyı bir kez kurup verinin otomatik akmasını sağlayabilirsiniz.

İçe aktarma sırasında en çok zaman kazandıran şey, bir önceki bölümde anlattığımız kural motorudur. Yüzlerce ham banka işlemini yükledikten sonra kurallarınızı toplu uygularsanız, "MIGROS" geçen her satır otomatik olarak Gıda kategorisine ve Market bütçesine düşer. Böylece içe aktarma, saatler süren manuel bir temizlik işi olmaktan çıkar. İçe aktarma araçlarını komut satırından zamanlanmış görevlerle otomatikleştirebilir, örneğin her sabah belirli bir CSV klasörünü tarayacak bir yapı kurabilirsiniz.

Raporlar ve Grafiklerle Finansal Görünüm#

Veriyi biriktirmenin bütün amacı, sonunda anlamlı bir tablo görmektir. Firefly III'ün raporlar bölümü tam da bunu sunar. Kontrol panelinde açılışta net değeriniz, hesap bakiyeleriniz, bütçe durumunuz ve son işlemleriniz özet olarak karşınıza gelir.

Raporlar bölümünde farklı bakış açıları vardır. Varsayılan rapor, seçtiğiniz dönem için gelir-gider dengesini, en çok harcama yapılan kategorileri ve hesap bazlı akışı gösterir. Bütçe raporu, hangi bütçelerin sınır içinde kaldığını hangilerinin aşıldığını netleştirir. Kategori raporu, harcamalarınızın zaman içinde nasıl değiştiğini karşılaştırmalı olarak sunar; örneğin akaryakıt harcamasının son altı ayda yükseldiğini bir çizgi grafikte hemen görürsünüz. Etiket ve gelir/gider raporları ise daha özel analizler için oradadır.

Firefly III ayrıca bir API sunar, böylece verinizi dışarı taşıyabilir ve başka araçlarla besleyebilirsiniz. Örneğin harcama verinizi bir veritabanına aktarıp daha gelişmiş görselleştirmeler için kod yazmadan analiz araçlarına bağlamak isterseniz, Metabase gibi bir iş zekası aracıyla çok daha zengin panolar oluşturabilirsiniz. İleri düzey bir örnek olarak, kategori bazlı aylık toplamı doğrudan veritabanından çeken bir sorgu şöyle görünebilir:

SELECT c.name        AS kategori,
       SUM(tj.amount) AS toplam
FROM transaction_journals tj
JOIN category_transaction_journal ctj ON ctj.transaction_journal_id = tj.id
JOIN categories c ON c.id = ctj.category_id
WHERE tj.date >= '2026-07-01'
GROUP BY c.name
ORDER BY toplam DESC;

Bu tür bir sorgu, Firefly III'ün kendi arayüzünün ötesinde, verinizin gerçekten sizin olduğunu ve dilediğiniz gibi işleyebileceğinizi gösterir. Bu esneklik, kapalı bir mobil bankacılık uygulamasının asla sunamayacağı bir özgürlüktür.

Kendi Sunucunuzda Barındırmanın Avantajları#

Firefly III'ü kendi sunucunuzda çalıştırmanın en güçlü gerekçesi gizliliktir. Finans verisi, bir insanın sahip olabileceği en hassas verilerden biridir; nereye para harcadığınız, ne kadar kazandığınız, hangi borçlarınız olduğu doğrudan özel hayatınızı anlatır. Bu veriyi bir başkasının bulutuna emanet etmek yerine kendi kontrolünüzdeki bir sunucuda tutmak, hem içinizi rahatlatır hem de veri sızıntısı riskini büyük ölçüde ortadan kaldırır. Verinin Türkiye'deki bir sunucuda durması, gizlilik açısından ayrı bir güven katmanı sağlar.

İkinci avantaj kalıcılık ve bağımsızlıktır. Ücretsiz mobil bütçe uygulamaları kapanabilir, ücretli plana geçebilir ya da veri dışa aktarma seçeneklerini kısıtlayabilir. Firefly III açık kaynak olduğu için böyle bir bağımlılık yaşamazsınız; uygulama sizin sunucunuzda çalıştığı sürece hep erişilebilir kalır ve verinizi istediğiniz an ham hâliyle dışarı alabilirsiniz. Aynı sunucuda dosyalarınız için bir Nextcloud kurulumu çalıştırıp kişisel dijital altyapınızı tek çatı altında toplamak da mümkündür.

Üçüncüsü maliyettir. Bir kez kurulan Firefly III, kullanıcı başına ücret istemez; sabit bir sunucu maliyetiyle sınırsız işlem, hesap ve rapor üretirsiniz. Aracı hazır bir ortamda hızlıca denemek isterseniz App Center kataloğumuza göz atabilir, sunucu tarafını ise ihtiyacınıza göre VDS seçeneklerimiz arasından seçebilirsiniz. Kurulum ve bakımı kendiniz üstlenmek istemiyorsanız, sunucu yönetimi hizmetimiz güncelleme ve yedekleme gibi işleri sizin yerinize yürütür.

Sıkça Sorulan Sorular#

Firefly III ücretsiz mi?#

Evet, Firefly III tamamen ücretsiz ve açık kaynaklıdır. Bir lisans ücreti, kullanıcı başına ödeme ya da işlem sınırı yoktur. Tek maliyetiniz, uygulamayı çalıştıracağınız sunucudur. Bu da onu uzun vadede ücretli bütçe uygulamalarına kıyasla oldukça ekonomik kılar.

Firefly III bankama otomatik bağlanır mı?#

Doğrudan her bankaya değil, ama içe aktarma aracı üzerinden çeşitli yöntemler sunar. Bankanızın internet şubesinden indirdiğiniz CSV dökümlerini içe aktarabilir, ya da açık bankacılığı destekleyen kurumlar için GoCardless veya SimpleFIN bağlantılarıyla işlemleri otomatik çekebilirsiniz. Türkiye'deki bankaların çoğunda en pratik yol, düzenli CSV içe aktarımını bir şablonla otomatikleştirmektir.

Verilerim güvende mi ve nerede tutuluyor?#

Verileriniz yalnızca sizin sunucunuzdaki veritabanında saklanır; Firefly III hiçbir veriyi dış bir servise göndermez. Güvenliği tamamen sizin kurulumunuz belirler. HTTPS ile yayınlamak, güçlü bir veritabanı parolası kullanmak ve düzenli yedek almak, verinizi koruyan temel önlemlerdir. Kendi sunucunuzda barındırdığınız için gizlilik konusunda üçüncü bir tarafa güvenmek zorunda kalmazsınız.

Firefly III mobil uygulaması var mı?#

Firefly III öncelikle web tabanlı bir uygulamadır ve arayüzü mobil tarayıcılarda düzgün çalışır. Bunun yanında, resmi API'yi kullanan topluluk tarafından geliştirilmiş mobil uygulamalar da mevcuttur; bunları kendi sunucunuzun adresine bağlayarak telefondan hızlı işlem girişi yapabilirsiniz. Yine de tüm gelişmiş raporlar ve kural yönetimi için web arayüzü ana kullanım noktasıdır.

Kural sistemi olmadan her işlemi elle mi girmem gerekir?#

Kurallar zorunlu değildir ama şiddetle önerilir. Kurallar olmadan da uygulama çalışır; her işlemi elle kategorize edebilirsiniz. Ancak birkaç iyi kural tanımladığınızda, özellikle banka verilerini içe aktardıktan sonra yüzlerce işlem otomatik olarak doğru kategori, bütçe ve etikete yerleşir. Bu, aylık finans bakımınızı saatlerden dakikalara indiren en değerli özelliktir.

Firefly III'ü küçük bir sunucuda çalıştırabilir miyim?#

Evet. Firefly III kaynak açısından hafif bir uygulamadır; kişisel kullanım için düşük donanımlı bir sanal sunucu bile yeterlidir. Genellikle 1-2 GB RAM'e sahip bir sunucu, uygulamayı ve veritabanını rahatça taşır. Kullanıcı sayısı ve işlem hacmi arttıkça kaynak ihtiyacı da artar, ancak tek kişilik ya da aile bütçesi için mütevazı bir sunucu fazlasıyla yeterlidir.

Kapanış#

Firefly III, kişisel finansı bir tahmin oyunu olmaktan çıkarıp somut, görünür ve yönetilebilir bir sürece dönüştürür. Hesaplar, kategoriler, bütçeler ve kural motoru bir araya geldiğinde; paranızın nereden gelip nereye gittiğini net biçimde görür, harcamalarınıza sınır koyar ve zaman içindeki eğilimlerinizi grafiklerle takip edersiniz. En önemlisi, bu hassas verinin tamamı sizin kontrolünüzde kalır.

Firefly III'ü kendi altyapınızda çalıştırmaya hazırsanız, uygulamayı barındıracak sunucuyu ihtiyacınıza göre sanal sunucu veya VDS seçeneklerimiz arasından seçebilir, güvenli erişim için SSL sertifikanızı dakikalar içinde devreye alabilirsiniz. Docker kurulumu, güncelleme ve yedekleme gibi bakım işlerini kendiniz üstlenmek istemiyorsanız, sunucu yönetimi hizmetimiz tüm bu süreci sizin yerinize yürütür. Finansal kontrolü kendi elinize almanın ilk adımını bugün atabilirsiniz.