AxiShieldAxiShield Docs
Customer PortalProduct site
AXISHIELD FIREWALL OS

Technical Documentation

Deploy, configure and operate AxiShield from the first installation through network segmentation, security policies, monitoring, maintenance and recovery.

AxiShield Firewall OS symbol
Documentation scope

This guide describes the standard AxiShield workflow and the modules available in the current platform family. Exact labels can vary slightly by release or licence edition. Changes affecting live traffic should be performed during a controlled maintenance window.

01

System requirements

Prepare the host and network topology before starting the installer.

Compute

Use a dedicated x86-64 host or virtual machine with sufficient CPU, memory and storage for the expected traffic volume, logging retention and inspection workload.

  • 64-bit processor with virtualization support
  • Minimum two network interfaces for routed deployments
  • Reliable local storage for logs and quarantine
  • UEFI or BIOS boot supported by the selected host

Network

Identify every physical or virtual interface before deployment. Record the intended WAN, LAN, management, CCTV or unassigned role for each port.

  • At least one Internet-facing WAN
  • At least one protected LAN or management interface
  • Additional wired WANs for failover or load balancing
  • Dedicated CCTV interface when camera isolation is required

Operational access

Keep local console access available during initial configuration. Incorrect role assignment, addressing or routing can interrupt remote access.

  • Console or hypervisor access
  • Customer Portal account and valid installer entitlement
  • Current network addressing plan
  • Maintenance window for production replacement
02

Installation

Install AxiShield through the authenticated deployment journey supplied by the Customer Portal.

  1. Prepare the target

    Back up any required data, connect the intended network interfaces and confirm local console access.

  2. Open the Customer Portal

    Sign in, select the licence or trial, choose the target device and open the installation journey.

  3. Generate the secure installer

    The portal creates a device-bound installation flow. Use only the command and token displayed for that device.

  4. Run the installer

    Execute the portal-provided command with administrative privileges on the supported Linux base. Do not reuse expired or previously committed pairing information.

  5. Follow progress

    The installer validates the host, retrieves signed components, installs services, registers the device and reports each stage.

  6. Restart when requested

    After completion, reboot the system if the installer or release notes require it. Keep the console visible until the AxiShield workspace loads.

Example workflow
# Use the exact secure command generated in Customer Portal
sudo <portal-provided-installer-command>

# After a successful installation, reboot only when requested
sudo reboot
Do not copy installation tokens into tickets or public messages.

Installer links, pairing codes and device tokens may grant temporary provisioning access. Generate a new flow if a secret is exposed.

03

First login and initial setup

Complete the minimum safe configuration before connecting production users.

04

Interface Manager

Interface roles define how AxiShield treats every connected network.

RolePurposeTypical behaviour
WANInternet or upstream connectivityGateway monitoring, routing, failover or load balancing
LANProtected client networkDHCP, DNS, forwarding and assigned security policies
MGMTAdministrative accessRestricted management plane with no unnecessary client services
CCTVCamera and recorder networkInternet access with predefined camera-focused protections and isolation
FREEAvailable or intentionally unassigned portNo automatic production role until configured

Recommended configuration order

1. Rename interfaces according to their physical purpose. 2. Assign roles. 3. Configure static or dynamic addressing. 4. Apply DHCP/DNS settings where relevant. 5. Assign application policies. 6. Test from a single controlled client before wider rollout.

05

Multi-WAN, failover and load balancing

Maintain upstream availability without allowing invalid routes to remain active.

Automatic failover

For two or more wired WAN interfaces, configure priority, health thresholds and failback behaviour. A failed or missing WAN is removed from active routing while its configuration and policy assignments remain preserved.

  • Use conservative failure thresholds to avoid flapping
  • Verify gateway, DNS and Internet reachability
  • Test cable removal and reconnection
  • Confirm automatic reintegration after recovery

Weighted load balancing

Distribute eligible sessions across healthy WANs using explicit weights. Weighting expresses preference; it does not guarantee identical bandwidth usage for every application.

  • Only healthy WANs participate
  • Every managed next hop must have a resolved gateway
  • Existing sessions may remain on their original path
  • Policy routing and VPN routes must be reviewed together
Validation test

Check the active default route, browse from a protected client, disconnect one WAN, confirm service continuity, then reconnect it and verify clean automatic reintegration.

06

DHCP and DNS

Deliver predictable client addressing and controlled name resolution per eligible interface.

DHCP service

Create a scope only on interfaces that should serve clients. Keep the gateway inside the interface subnet and exclude infrastructure addresses from the dynamic pool.

  • Define start and end addresses
  • Set lease duration
  • Add reservations for stable devices
  • Publish AxiShield as the gateway and approved DNS resolver

DNS service

Use the DNS module to control upstream resolvers, local behaviour and security filtering. Confirm that AxiShield itself can resolve names before diagnosing client-side DNS.

  • Choose trusted upstream resolvers
  • Apply DNS filtering policies by interface
  • Review blocked-domain events
  • Prevent unmanaged bypass where required by policy
07

Firewall policies

Create reusable policies first, then assign them to one or more interfaces.

AxiShield keeps application policies separate from interface configuration. A firewall policy can be created, renamed, duplicated and edited without being applied. Assignment is explicit and may target zero, one or several interfaces.

Build

Define the policy objective, default action, services, ports, addresses, direction and logging requirements.

Assign

Select the LAN, CCTV or other eligible interfaces that should use the policy. Review conflicts before activation.

Validate

Test allowed business traffic and at least one expected denial. Review logs to confirm the correct rule is responsible.

Example: “Required services only”

Start with deny-by-default, then permit only the ports genuinely required by the protected environment. Duplicate the policy when another network needs a similar but not identical rule set.

08

Network Protector (IDS/IPS)

Detect suspicious network behaviour and optionally prevent confirmed threats.

Detection mode

Begin in detect-only mode when introducing the engine to an existing production network. Review alerts, grouped analysis and repeated patterns before enabling blocking.

Prevention mode

Enable IPS after validating signatures and expected traffic. Monitor Internet access and essential applications immediately after activation.

  • Port-scan and behavioural detection
  • Grouped event analysis
  • Per-interface visibility
  • Persistent runtime supervision
  • Policy-driven enforcement
  • Correlation with threat intelligence
09

Network File Inspection

Inspect eligible files observed in network traffic without replacing endpoint protection.

Assign Network File Inspection to the required LAN-facing interfaces. Start in passive detection mode, generate a controlled test event and confirm that the file, source, destination and verdict appear in the interface.

Encrypted traffic limitation

File visibility depends on protocol, encryption and deployment design. Do not claim inspection coverage for content AxiShield cannot observe.

10

Malware protection and quarantine

Scan authorised storage locations and isolate suspicious files with traceable evidence.

Scanning

Use Quick Scan for routine checks and Full Scan for deeper review of authorised AxiDrive and USB locations. Progress, cancellation and results remain visible to the administrator.

Quarantine

Quarantined files are held in a restricted location with metadata, history and SHA-256 identification. Restore only after a documented review.

Safe response sequence

Disconnect the affected workflow if necessary, preserve the alert, verify the hash and source, review related network events, then delete or restore according to the organisation’s incident process.

11

Threat Intelligence

Maintain trusted indicators and correlate them with local security events.

The Threat Intelligence module supports curated external sources and administrator-managed indicators. Current deployments can correlate recognised malicious infrastructure, certificate fingerprints or known exploited vulnerabilities with observed activity.

Source typeUseOperational note
CISA KEVKnown exploited vulnerabilitiesUse to prioritise exposure and remediation; it is not a network blocklist by itself.
Feodo C2Known command-and-control infrastructureReview destination matches and affected internal devices.
SSL certificate intelligenceMalicious certificate fingerprintsCorrelate with encrypted infrastructure where visibility permits.
Custom IOCOrganisation-specific indicatorsDocument owner, source, expiry and confidence.
12

Web and DNS filtering

Apply browsing controls without merging them into the firewall rule base.

Create independent filtering policies, define categories or explicit domain decisions, then assign those policies to the intended interfaces. Use narrow exceptions with an owner and review date rather than weakening the entire policy.

13

AxiVPN outbound routing

Route selected protected interfaces through named outbound VPN tunnels.

AxiVPN is managed as a client tunnel, not as a general remote-access VPN server. Create a named tunnel, configure its provider or server parameters, then assign zero, one or multiple interfaces. Traffic from clients on those interfaces exits through the selected tunnel.

Tunnel configuration

  • Clear name such as vpnUK
  • Server or country selection
  • Credentials and authentication parameters
  • Connection health and reconnection behaviour

Assignment review

  • Confirm affected interfaces
  • Verify public egress address
  • Test DNS behaviour
  • Define expected behaviour when the tunnel is unavailable
14

CCTV network protection

Isolate camera infrastructure while preserving controlled Internet access.

Assign the CCTV role to the interface serving cameras, recorders or related devices. AxiShield applies the CCTV network model and exposes the relevant protections across Firewall, DNS, Network Protector, Traffic Monitor and other supported applications.

Recommended principle

Permit only the destinations and services required for camera operation, updates, time synchronisation and authorised remote management. Do not allow unrestricted access from CCTV devices to user networks.

15

Traffic monitoring and visibility

Use shared evidence to understand health, performance and security activity.

  • Interface state and throughput
  • WAN health and route status
  • Top clients and destinations
  • Firewall and security events
  • File inspection verdicts
  • Threat intelligence correlations

When investigating an incident, correlate time, source interface, client address, destination, policy and action rather than relying on a single counter.

16

Notifications

Surface actionable changes without flooding administrators during startup.

Use notification severity and source to distinguish information from action. Prioritise failed security services, persistent WAN loss, licence problems, update failures, quarantine events and configuration changes. Routine startup transitions should not be treated as incidents unless they remain unresolved.

17

AxiDrive and authorised USB storage

Handle downloaded and removable files without exposing the wider operating system.

AxiDrive is a restricted file workspace. It provides access to the AxiShield downloads area and authorised USB media, but not to the rest of the system. Use it to review, copy, export or scan files under controlled policies.

USB policy

Unknown or untrusted media should remain read-only until scanned and explicitly approved. Removing the USB device during a copy or scan can corrupt the operation.

18

Updates, rollback and recovery

Apply signed releases while preserving a stable and recoverable base.

  1. Read release notes

    Confirm scope, prerequisites, expected service interruption and reboot requirement.

  2. Back up configuration

    Export or record critical settings before a production change.

  3. Install from Update Center

    Keep the progress view open and do not interrupt package verification, file commit or service reload.

  4. Validate after update

    Check WAN, DNS, client Internet access, firewall state and the modules modified by the release.

  5. Use recovery only when needed

    Rollback must return to the last validated complete package, not to an arbitrary mixture of files.

19

Licensing and Customer Portal

Manage entitlement, devices, secure installers and account recovery outside the firewall workspace.

Licences

Review edition, state, validity and eligible device capacity.

Devices

Authorise, identify and manage installations linked to the organisation.

Installers

Create secure device-specific installation journeys and review their status.

20

Daily and periodic operations

A simple routine prevents small warnings from becoming service incidents.

FrequencyReview
DailyWAN status, critical notifications, blocked threats, quarantine and failed services.
WeeklyPolicy changes, top traffic, repeated detections, device inventory and backup status.
MonthlyAdministrator accounts, exceptions, unused rules, licence state, update level and recovery readiness.
After every changeManagement access, DNS, Internet access, affected applications and rollback evidence.
21

Troubleshooting

Start with the lowest layer and isolate one variable at a time.

No Internet from protected clients
  1. Check physical link and interface role.
  2. Confirm the client received the correct IP, gateway and DNS.
  3. Verify WAN IPv4 address and resolved gateway.
  4. Confirm the active default route contains a valid gateway.
  5. Test Internet access from AxiShield itself.
  6. Review firewall, VPN and DNS policy assignments.
DNS names do not resolve
  1. Test direct IP connectivity.
  2. Verify upstream DNS reachability from AxiShield.
  3. Check that the client uses the intended resolver.
  4. Review DNS filtering events and local policy.
A network interface disappears
  1. Keep the global firewall active.
  2. Confirm the interface is shown as missing rather than deleted.
  3. Reconnect or restore the adapter.
  4. Verify automatic state and policy restoration.
An update does not complete
  1. Do not repeatedly reboot during file commit.
  2. Record the exact stage and error.
  3. Use Update Center recovery or the approved last stable package.
  4. Validate networking before applying any later patch.
22

Production security baseline

Complete this checklist before declaring a deployment ready.

AxiShield
AXISHIELD DOCUMENTATION

Protection that remains understandable.

Build the network in layers, validate every change and keep recovery available.

Back to top ↑