> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fire.rest/llms.txt
> Use this file to discover all available pages before exploring further.
# Terminal requirements
> Minimum and recommended hardware, operating system, browser and network requirements to run FIRE POS on a point-of-sale terminal.
FIRE POS is a web application (PWA) served from the cloud: the terminal does not run the application, it only opens it in a browser. There is no executable or installer to download — you reach it at a URL. The only component installed locally is **Fire Agent**, required to print receipts and open the cash drawer.
## Addresses
| Environment | FIRE POS (terminal) | Backoffice |
| -------------- | ---------------------------------------------- | ---------------------------------------------- |
| **Production** | [pos.fire.rest](https://pos.fire.rest) | [app.fire.rest](https://app.fire.rest) |
| **Staging** | [stg.pos.fire.rest](https://stg.pos.fire.rest) | [stg.app.fire.rest](https://stg.app.fire.rest) |
Staging is the test environment: use it for training, validation and integration testing, never to run a real store.
The two environments are completely separate. A linking code generated in the production backoffice **does not work** on the staging POS, and vice versa. Terminals, cashiers, sales and register closes are not shared between environments either.
Before linking a terminal, check that the backoffice and the POS are on the same environment.
## Summary
| Component | Minimum | Recommended |
| ---------------- | --------------------------------- | ----------------------------------- |
| Operating system | Windows 10 (64-bit) | Windows 11 (64-bit) |
| Processor | x64, 2 cores, 1.5 GHz | x64, 4 cores, 2.0 GHz |
| RAM | 4 GB | 8 GB |
| Storage | 64 GB, with 10 GB free | 128 GB SSD, with 20 GB free |
| Ports | 2 free USB + Ethernet | 4 free USB + Ethernet |
| Display | 1024 × 768, landscape | 1366 × 768 or higher, landscape |
| Input | Touchscreen or keyboard and mouse | Capacitive touchscreen |
| Browser | Chrome / Edge 105, Firefox 110 | Latest stable Chrome or Edge |
| Connection | 5 Mbps down / 2 Mbps up per store | 20 Mbps down / 10 Mbps up per store |
| Backend latency | RTT below 150 ms | RTT below 80 ms |
FIRE POS **requires a permanent internet connection**. There is no offline mode today: without network the terminal cannot authenticate cashiers, load the catalog or record sales.
## What runs on the terminal
| Component | Where it runs | Required |
| -------------- | ---------------------------------------- | --------------------------------------------- |
| **FIRE POS** | Terminal browser, at the environment URL | Yes |
| **Fire Agent** | Local Windows executable | Only if the terminal prints or opens a drawer |
FIRE POS can be installed as an app from the browser (PWA) so it opens full screen, without an address bar.
The Fire backoffice, where terminals, cashiers and authorization codes are managed, is a separate application and is not opened from the point-of-sale terminal. See [Addresses](#addresses) for the URL of each environment.
## Operating system
FIRE POS runs on **Windows 10 or Windows 11, 64-bit**. It is the only supported platform, and the only one where thermal printing and the cash drawer work.
The terminal also needs:
* **Administrator** rights during Fire Agent installation or uninstallation only.
* **PowerShell 5.1** or later (already included in Windows 10/11).
* The **thermal printer driver** already installed in Windows.
Fire Agent listens locally only, so there is no need to open ports or create Windows Firewall rules. See the [Fire Agent installation guide](/en/manuals/fire-agent/installation).
## Processor, memory and storage
| Resource | Minimum | Recommended |
| --------- | ---------------------- | --------------------------- |
| Processor | x64, 2 cores, 1.5 GHz | x64, 4 cores, 2.0 GHz |
| RAM | 4 GB | 8 GB |
| Storage | 64 GB, with 10 GB free | 128 GB SSD, with 20 GB free |
FIRE POS takes no space of its own — it uses the browser cache. Fire Agent takes under 100 MB.
Disk type is what shows most in terminal and browser startup:
| Disk type | Startup |
| --------------------- | ---------------- |
| **SSD** — recommended | ▰▰▰▰▰ Excellent |
| HDD 7200 rpm | ▰▰▰▱▱ Acceptable |
| HDD 5400 rpm | ▰▱▱▱▱ Slow |
The browser must be **allowed to keep site data** across sessions. If a store policy clears it on close, or if the terminal runs in incognito/private mode, the terminal **loses its link** and must be registered again with a new code.
## Ports and connectivity
| Port | Minimum | Recommended |
| ---------------- | ------- | ----------- |
| Free USB type A | 2 | 4 or more |
| Ethernet (RJ-45) | 1 | 1 |
Free USB ports are counted **in addition** to those already taken by the thermal printer and the keyboard. They are needed to add a barcode scanner, scale, numeric keypad, second printer or a network adapter without relying on an external hub.
A powered USB hub solves a shortage of ports, but adds one more point of failure at the counter. Choosing a terminal with enough ports from the start is preferable.
## Display and resolution
FIRE POS uses a full-screen, **landscape** layout with no page scrolling. The product grid adds columns according to the available width.
| Resolution | Product columns | Assessment |
| ----------------------- | --------------- | ---------------------- |
| 1024 × 768 | 3 | **Minimum supported.** |
| 1280 × 800 – 1366 × 768 | 4 | Comfortable. |
| 1366 × 768 – 1600 × 900 | 5 | Recommended. |
| 1920 × 1080 and above | 6 or more | Optimal. |
* **Landscape orientation.** The layout assumes more width than height.
* **Minimum height of 768 px.**
* **Windows scaling at 100 %.** A higher scale reduces usable space.
* **Browser zoom at 100 %.** FIRE POS pins the zoom level and disables pinch gestures.
### Input
FIRE POS is operated with a **touchscreen or with keyboard and mouse**. Controls are sized with a 56 px touch target, designed for finger operation.
A capacitive touchscreen is recommended (resistive works, but is less precise), along with a numeric keypad for cashier PIN entry and authorization codes.
## Browser
**Chrome or Edge on their latest stable version** is recommended. These are the browsers FIRE POS is tested on, and the ones that automatically trust the Fire Agent certificate.
### Minimum versions
| Browser | Minimum version | Recommended |
| --------------- | --------------- | ---------------- |
| Google Chrome | 105 | Latest stable |
| Microsoft Edge | 105 | Latest stable |
| Mozilla Firefox | 110 | 115 ESR or later |
These are the first versions that support the web features FIRE POS needs. On earlier versions the application does not load correctly.
**Internet Explorer and Edge Legacy are not supported.** Neither are older embedded browsers shipped with POS terminals: if the device comes with a built-in browser that cannot be updated, install Chrome or Edge.
### Required browser configuration
| Requirement | Reason |
| ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------- |
| Access over **HTTPS** | FIRE POS security requirement. |
| **Do not use incognito or private mode** | The terminal loses its link when the browser closes. |
| **Do not clear site data on close** | Same reason. |
| Allow local connections | The POS communicates with Fire Agent locally. Some security extensions and proxies block it. |
| Trust the Fire Agent certificate | Chrome, Edge, Brave and Opera do this automatically. Firefox requires enabling `security.enterprise_roots.enabled`. |
| Zoom at 100 % | See [Display and resolution](#display-and-resolution). |
## Network and bandwidth
### Usage
| Activity | Frequency | Approximate volume |
| ------------------------ | ------------------------------------------ | ------------------------------------------- |
| Initial application load | First open and after each update | About 215 kB compressed. Cached afterwards. |
| Terminal state sync | Every 60 seconds | A few kB. |
| Catalog download | On register open and when the menu changes | Depends on menu size. |
| Recording a sale | One request per order | A few kB. |
| Printing and drawer | Per receipt | Local traffic, consumes no internet. |
### Link requirements
| Parameter | Minimum | Recommended |
| ------------------------------ | ------------ | ----------- |
| Download per store | 5 Mbps | 20 Mbps |
| Upload per store | 2 Mbps | 10 Mbps |
| Additional per active terminal | 512 kbps | 1 Mbps |
| Backend latency (RTT) | below 150 ms | below 80 ms |
| Packet loss | below 1 % | below 0.1 % |
| Jitter | below 30 ms | below 10 ms |
For FIRE POS, **stability and latency matter more than bandwidth**. Wired Ethernet is recommended over Wi-Fi, along with a backup link (4G/5G) with automatic failover.
### Corporate network
If the store operates behind a corporate proxy or firewall, allow:
* **HTTPS (443)** to the FIRE POS and Fire backend domains.
* **Local traffic** for Fire Agent. It never leaves the machine, but some security suites intercept it.
* **NTP** to keep the terminal clock synchronized.
Ask the Fire team for the domain list for your country and environment — they vary by deployment region.
## Peripherals
| Peripheral | Requirement | Notes |
| --------------- | ------------------------------------------------------------ | ----------------------------------------------------------------------------- |
| Thermal printer | **ESC/POS** compatible, with the driver installed in Windows | The **"Generic / Text Only"** driver or a raw-configured port is recommended. |
| Cash drawer | Connected to the thermal printer | Opened through the printer, takes no USB port of its own. |
| Barcode scanner | USB, in keyboard emulation mode | Requires a free USB port. |
## Deployment recommendations
Open the environment URL ([pos.fire.rest](https://pos.fire.rest) in production) in Chrome or Edge and install it from the browser so it opens full screen, without an address bar.
Check **Settings → System → Display → Scale** on every terminal.
The terminal clock affects credential validity and sales timestamps.
Add exclusions for `C:\Program Files\FireAgent` and `%APPDATA%\FireAgent`. Packaged Node executables trigger false positives.
## Next step
Register the terminal against a store with a single-use code.
Enable thermal printing and the cash drawer on the terminal.