FiscalNet
FiscalNet · Linux

Install and configure FiscalNet on Linux

From installing FiscalNet to connecting your point-of-sale application, in five illustrated steps.

HTTP integration on Linux
Installation steps 1 / 5

Step 1 of 5

Before you begin

Prepare a desktop Linux x64 system and the confirmed cash-register settings. The application was checked in the laboratory on Ubuntu 24.04 LTS; confirm compatibility with other distributions for the package you use.

On Linux, use the manual configuration in this guide. Automatic discovery is not yet functional.

01Install FiscalNet

The Linux installer will be available soon. If FiscalNet is already installed, continue with step 2.

02Start FiscalNet

Start FiscalNet and check that the Cash Registers page opens. If you have a FiscalNet shortcut, you can use it to start the application.

FiscalNet on Linux · cash-register page
Linux interface from the laboratory. Device name and identification are masked.

03Add the device manually

In the app, choose Case de marcat → Adaugă → Manual. Select the manufacturer and enter the device name.

Add cash register dialog in FiscalNet Linux · choose Manual
Authentic Linux capture: select Manual. Open the image to enlarge it.

04Configure the connection

Network

Choose LAN / Wi-Fi and enter the confirmed device IP address and TCP port. The Linux computer and cash register must be able to communicate on the configured network.

USB / Serial

Choose USB / Serial and the serial port recognised by Linux. Check the port path and access permissions on the system in use. In a virtual machine, the USB device must be available inside Linux.

Use Testează conexiunea și salvează. Confirm the cash-register identification and status before use; checking the connection does not require issuing a receipt or Z report.

05Connect your sales application

With FiscalNet running, check the local service from the terminal:

curl http://127.0.0.1:65400/api/health

Your sales-application provider configures HTTP integration with POST /api/Receipt and handles the operation response. Another computer on the network uses the address of the device running FiscalNet and the access rules set by the administrator.

Linux integration documentation

Help and resources

If the application does not start, note your Linux distribution and the error message for support. For USB connection issues, check the port and your account permissions.

Technical resources for the administrator

Avalonia · Desktop Linux · Microsoft · .NET deployment