KSeFkaKSeFka

KSeF na Linuksie

KSeFka ma natywny build na Linuksa: pakiet .deb dla Debiana i Ubuntu albo AppImage, który uruchomisz na dowolnej dystrybucji.

Czego potrzebujesz

  • Dystrybucja 64-bitowa na architekturze x86_64.
  • Biblioteka webkit2gtk-4.1, obecna w Ubuntu od 22.04 i w Debianie od 12. Na starszych wydaniach aplikacja się nie uruchomi.

Który plik pobrać

  • Debian, Ubuntu i pochodne

    KSeFka_0.14.0_x86_64.deb53.5 MB

    Instaluje się jak zwykły pakiet systemowy, z wpisem w menu aplikacji.

  • Pozostałe dystrybucje

    KSeFka_0.14.0_x86_64.AppImage123.9 MB

    Jeden plik, który uruchamiasz z katalogu domowego. Działa też tam, gdzie pakiety systemowe wymagałyby uprawnień administratora.

Starsze wydania i pliki dla innych systemów są na stronie Pobierz.

Instalacja krok po kroku

  1. Instalacja pakietu .deb

    Z katalogu, do którego pobrałeś plik:

    sudo apt install ./KSeFka_*_x86_64.deb

    Gwiazdka podstawia numer wersji, więc komendę kopiujesz bez zmian. apt dociągnie brakujące zależności, a KSeFka pojawi się w menu aplikacji.

  2. AppImage: nadaj prawo uruchamiania
    chmod +x KSeFka_*_x86_64.AppImage

    Można też przez menedżer plików: Właściwości → Uprawnienia → "Zezwól na uruchamianie".

  3. AppImage: uruchom
    ./KSeFka_*_x86_64.AppImage

    Jeśli plik nie startuje i w terminalu pojawia się błąd o FUSE, twoja dystrybucja nie ma biblioteki libfuse2. Zainstaluj ją albo pomiń, uruchamiając plik z flagą --appimage-extract-and-run.

  4. Gdy okno nie wstaje na Wayland

    W wersjach do 0.13.2 włącznie aplikacja potrafiła zginąć na sesji Wayland, zanim pokazała okno. Zapamiętany rozmiar okna rósł przy każdym uruchomieniu na zestawie monitorów o różnym skalowaniu, aż przekroczył to, co obsługuje GTK. Skasuj zapamiętany rozmiar:

    rm ~/.config/pl.nod.ksefka/.window-state.json

    Plik trzyma wyłącznie rozmiar i położenie okna. Faktury, kontrahenci i dane firmy leżą w osobnej bazie, której to nie dotyka. Nowsze wersje pilnują tego same.

    Jeśli okno nadal nie wstaje, uruchom przez XWayland i daj nam znać:

    GDK_BACKEND=x11 ksefka-app

Aktualizacje

Na Linuksie nie ma aktualizacji automatycznych. Nową wersję pobierasz ze strony Pobierz i instalujesz tak samo jak poprzednią. Baza danych zostaje na miejscu, nic nie trzeba przenosić. Co się zmieniło, sprawdzisz w historii wersji.

Gdzie trafiają dane

Faktury, kontrahenci i dane firmy siedzą w bazie SQLite w ~/.local/share/pl.nod.ksefka/. Katalog przeżywa reinstalację, więc warto obejmować go kopią zapasową. Nic stąd nie trafia na nasze serwery; dane opuszczają komputer wyłącznie w drodze do KSeF.

Co dalej

Po instalacji zostaje konfiguracja: wybór środowiska KSeF, dane firmy i autoryzacja w KSeF. Prowadzą przez to Pierwsze kroki. Jeśli coś nie działa, zgłoś to.