Network Configurations
EPOS supports two network configurations: local network and external network. Understanding the differences helps you choose the right setup for your environment.
Local Network
Both the POS system and terminal are on the same network (LAN/WiFi).
Advantages
- Simple setup – No firewall or routing configuration needed
- Direct communication – POS connects directly to terminal IP
- Lower latency – No internet round-trip
- More secure – Traffic stays on the local network
When to Use
- Single-location deployments
- Terminal and POS in the same physical space
- No need for remote management
Configuration
- Connect both devices to the same network.
- Note the terminal's IP address from Integration status.
- Use this IP in your API requests.
External Network (Internet)
The terminal accepts commands from outside the local network via the internet.
Advantages
- Remote access – Manage terminals from anywhere
- Cloud integration – Works with cloud-based POS systems
- Multi-location – Central system controls many terminals
When to Use
- Cloud-based POS systems
- Multiple locations managed centrally
- Terminal and POS on different networks
- Mobile or temporary setups
Requirements
The terminal needs a static IP address accessible from the internet:
| Option | Description |
|---|---|
| SIM with static IP | Mobile provider assigns a fixed public IP to the SIM |
| Network static IP | Connect to a network with a static IP and configure port forwarding |
Configuration
Choosing the Right Configuration
| Factor | Local Network | External Network |
|---|---|---|
| Setup complexity | Simple | Moderate |
| Internet required | For transactions only | For all communication |
| Static IP needed | No | Yes |
| Security exposure | Lower | Higher |
| Latency | Lower | Higher |
| Remote management | No | Yes |
Security Considerations
Local Network
- Ensure your WiFi network is secured (WPA2/WPA3)
- Use network segmentation if possible
- Restrict access to the network
External Network
- The terminal is exposed to the internet
- Always use HTTPS
- Keep pairing codes confidential
- Monitor for unauthorized access attempts
- Consider VPN for additional security (note: terminal VPN not supported)
Port Requirements
| Port | Protocol | Purpose |
|---|---|---|
| 8080 | HTTPS | EPOS API |
For external network, ensure port 8080 is accessible from the internet (via SIM static IP or port forwarding).
Related
- How EPOS Communication Works – Understanding the API flow