referenceFortinet

FortiGate get system arp

Jump to content ↓

Display the FortiGate ARP table to map IPv4 addresses to learned MAC addresses and interfaces during local-network troubleshooting.

beginnerrisk: noneFreshFortiOS 7.4
Last verified 2026-09-17 · Next review 2027-03-16
FortinetFortiGatereference
01Before you run this

Read-only or non-disruptive in normal use. Validate the target context before relying on the output.

02Applies to

FortiGate · FortiOS · 7.4

When to use this content

Use this reference when you need to inspect, validate or explain the current state of FortiGate during operational troubleshooting.

Technical article

Overview

get system arp displays IPv4 ARP entries learned by the FortiGate.

ARP maps IPv4 addresses to MAC addresses on directly connected Layer 2 networks. The table is useful when validating whether the FortiGate has recently communicated with a local device and on which interface that neighbor was learned.

Command

bash
get system arp

Typical output

text
Address         Age(min)  Hardware Addr       Interface
10.1.10.20      0         00:11:22:33:44:55   VLAN10
10.1.50.10      2         aa:bb:cc:dd:ee:ff   VLAN50

Fields

Address

The IPv4 address associated with the ARP entry.

Age

The age of the learned entry, shown in minutes in the standard table output.

Hardware Addr

The MAC address associated with the IPv4 neighbor.

Interface

The FortiGate interface on which the neighbor is reachable.

When to use it

Use get system arp when:

  • A directly connected host cannot be reached.
  • You need to confirm which MAC address owns an IP address.
  • You suspect an IP conflict.
  • You need to verify the interface on which a local endpoint is learned.
  • A firewall policy is correct but local delivery still fails.
  • You are checking whether a device has recently communicated with the FortiGate.

How to interpret the result

Expected IP and MAC are present

This proves the FortiGate currently has an ARP mapping for that local IPv4 address.

It does not prove that the endpoint application is reachable or that a firewall policy permits all relevant traffic.

IP is present with an unexpected MAC

Possible causes include:

  • Duplicate IP address
  • Device replacement
  • Stale ARP information
  • Virtual IP ownership changes
  • HA or virtualization behaviour

Confirm the MAC address against the endpoint, switch CAM/MAC table, DHCP lease, or inventory.

IP is absent

Possible explanations include:

  • No recent Layer 3 communication with the host
  • Host offline
  • Wrong VLAN
  • Wrong subnet mask
  • Layer 2 path failure
  • The destination is not actually directly connected

Generate traffic, for example with a ping from the FortiGate, then inspect the table again.

Detailed ARP cache

For more detailed ARP information, Fortinet also documents:

bash
diagnose ip arp list

This can expose additional internal state not shown by the simpler get system arp output.

Validation workflow

For a local host such as 10.1.10.20:

  1. Confirm the FortiGate interface belongs to the same subnet.
  2. Run:
bash
get system arp
  1. Check whether 10.1.10.20 is present.
  2. Compare the MAC with the expected endpoint.
  3. If absent, generate traffic:
bash
execute ping 10.1.10.20
  1. Inspect ARP again.
  2. If still absent, troubleshoot Layer 2/VLAN connectivity.

Risks and considerations

This command is read-only and has no direct operational impact.

The main limitation is scope: ARP applies only to directly reachable IPv4 neighbors. You should not expect the FortiGate to have an ARP entry for a host several routed hops away.

  • FortiGate execute ping
  • FortiGate packet sniffer
  • FortiGate routing table

Sources

See the authoritative Fortinet reference in the article metadata.

Guided learning

This article is part of a path

FortinetFortiGate Traffic TroubleshootingStep 1/6 · next: Test controlled IP reachability
View path →
Technical path

Knowledge graph

Explicit editorial relationships across prerequisites, commands, troubleshooting, Labs and next steps.

Knowledge quality

Did this article help you solve the problem?

Each account can vote once per article. You can change your vote without increasing the total count.