Ga naar hoofdinhoud

XFA installeren

Er zijn twee manieren waarop je meestal op het installatiescherm terechtkomt:

  • Je gaat zelf naar https://web.xfa.tech/installation en klikt op de knop Download & installeer XFA.
  • Je bedrijf vraagt je om je toestel te verifiëren (per e-mail of wanneer je je aanmeldt bij een applicatie), en je krijgt een scherm te zien zoals hieronder.
Installatie-instructies bij het verifiëren van een toestel

Iedereen kan XFA in een paar minuten installeren. Je hebt er geen account en geen speciale rechten voor nodig. Volg hieronder de instructies voor jouw type toestel.

Voor desktoptoestellen (Windows, macOS)

  1. Klik op de knop Download & installeer XFA in het verificatiescherm. Het downloaden van de XFA Desktop Application start dan.
De XFA Desktop Application downloaden


  1. Open het gedownloade bestand en volg de installatiestappen, te beginnen met Doorgaan of Installeren. Op Windows werkt hetzelfde installatieprogramma op x64- en Arm64-toestellen, ook op Copilot+ pc's met een Arm-processor: op Arm64 schakelt XFA met een latere update over naar zijn native Arm64-versie.
Installatie-instructies voor macOS
Installatie-instructies voor Windows


  1. Ga terug naar het browsertabblad. Je ziet Zoeken naar de XFA-app. Klik op Verbinden met de XFA-app zodat de browser de app kan bereiken.
Scherm Checking for the XFA app


  1. Sta lokale netwerktoegang toe als je browser daarom vraagt.

    De aanmeldpagina praat met de XFA-app die op je eigen computer draait. De eerste keer vragen recente versies van Chrome, Edge en Firefox toestemming voor Lokale netwerktoegang of Apps op apparaat. Sta die toe zodat de verbinding tot stand kan komen. Daarmee kan de pagina alleen de XFA-app op je toestel bereiken.

    Heb je de toestemming geblokkeerd, dan meldt het scherm dat. Klik op het pictogram links van het webadres, sta de toestemming voor deze site toe, klik op Ververs en daarna opnieuw op Verbinden met de XFA-app.

  2. In Safari en Brave opent de browser de app in plaats daarvan via een xfatech://-link. Nadat je op Verbinden met de XFA-app klikt, vraagt de browser of XFA geopend mag worden. Sta dat toe, en kies, als de browser het aanbiedt, om deze site altijd toe te staan, zodat de vraag niet terugkomt.

Pop-up van de browser met de vraag om de XFA-applicatie te openen


  1. Klik na het verbinden op Verifiëren om af te ronden. Begin je ook je toestelstatus met je organisatie te delen, dan heet de knop Verifiëren & Accepteren.

Voor Linux-toestellen

Op Linux installeer je XFA met één commando. Het werkt op de meeste distributies, op zowel x86_64 als ARM64, installeert XFA in ~/.local/bin, en heeft geen rootrechten of package manager nodig. Op NixOS voeg je XFA in plaats daarvan toe aan je systeemconfiguratie, zoals beschreven in het onderdeel Op NixOS.

Op Ondersteunde Linux-systemen lees je welke distributies, versies en desktops XFA ondersteunt.

  1. Kopieer in het verificatiescherm het commando uit de installatiekaart en voer het uit in je terminal:
curl -fsSL https://distribution.xfa.tech/xfa-native-desktop-application/install.sh | sh

  1. Ga terug naar het browsertabblad zodra het installatieprogramma klaar is en klik op Verbinden met de XFA-app.

    Net als op Windows en macOS vraagt je browser mogelijk toestemming voor Lokale netwerktoegang of Apps op apparaat. Sta die toe om verder te gaan. Heb je ze geblokkeerd, klik dan op het pictogram links van het webadres, sta de toestemming voor deze site toe en klik daarna op Ververs.

Op NixOS

Op NixOS is XFA een nix-pakket in je systeemconfiguratie. Het werkt zichzelf niet bij: het gaat naar de nieuwste versie telkens wanneer je je systeem bijwerkt.

  1. Voeg XFA toe aan de inputs van je systeemflake (flake.nix):
inputs.xfa.url = "https://distribution.xfa.tech/xfa-native-desktop-application/nix/xfa.tar.gz";
inputs.xfa.inputs.nixpkgs.follows = "nixpkgs";
  1. Voeg het pakket toe aan je NixOS-configuratie:
environment.systemPackages = [ inputs.xfa.packages.${pkgs.stdenv.hostPlatform.system}.default ];

Je NixOS-configuratie heeft voor deze regel de flake-inputs nodig: geef ze door aan je modules met specialArgs = { inherit inputs; }; in nixpkgs.lib.nixosSystem, en voeg inputs toe aan de argumenten van de module.

Wil je XFA voor één persoon installeren, voeg het dan in plaats daarvan toe aan users.users.<name>.packages. Gebruik je home-manager als NixOS-module, zet dan home-manager.useUserPackages = true.

  1. Bouw je systeem opnieuw:
sudo nixos-rebuild switch

  1. Voer xfa één keer uit in een terminal, aangemeld als de persoon die het toestel gebruikt.

  2. Ga terug naar het browsertabblad en klik op Verbinden met de XFA-app.

Tray-icoon op GNOME

XFA staat in het systeemvak. GNOME heeft standaard geen systeemvak: voeg pkgs.gnomeExtensions.appindicator toe aan environment.systemPackages en zet de extensie aan. KDE Plasma en de meeste andere desktops hebben niets extra nodig.

Als je systeem configuration.nix gebruikt

Heeft je systeem geen flake.nix, voeg dit dan toe aan je configuration.nix in plaats van stap 1 en 2. De module heeft lib nodig in zijn argumenten, bijvoorbeeld { config, pkgs, lib, ... }.

environment.systemPackages = [
  (pkgs.callPackage (builtins.fetchTarball
    "https://distribution.xfa.tech/xfa-native-desktop-application/nix/xfa.tar.gz") { })
];
nixpkgs.config.allowUnfreePredicate = pkg: lib.getName pkg == "xfa";

Bouw daarna je systeem opnieuw en ga verder met stap 4:

sudo nixos-rebuild switch

XFA bijwerken op NixOS

XFA gaat naar de nieuwste versie wanneer je je systeem zoals gewoonlijk bijwerkt:

nix flake update
sudo nixos-rebuild switch

Wil je alleen XFA bijwerken, voer dan nix flake update xfa uit in plaats van nix flake update.

Zonder flake.nix haalt elke rebuild de nieuwste versie op zodra de downloadcache verlopen is (standaard na een uur).

De XFA die draait, schakelt vanzelf over naar de nieuwe versie. Heb je XFA op een andere manier geïnstalleerd, bijvoorbeeld met nix profile install of een losse home-manager, dan blijft de oude versie draaien tot je je de volgende keer aanmeldt.

De knop Oplossen bij de controle op besturingssysteemupdates werkt niet op NixOS: die meldt dat dit niet ondersteund wordt. Werk NixOS bij zoals je dat gewoonlijk doet.

Voor mobiele toestellen (iOS, Android)

  1. Klik op Installeer de XFA app op het scherm, of zoek XFA in de App Store of Google Play Store.
  1. Ga terug naar het verificatiescherm om de verificatie van je toestel af te ronden.