Excalibur's Sheath

Troubleshooting Network Issues Like a Pro

Jul 6, 2025 By: Jordan McGilvraytroubleshooting,network,cli,ping,traceroute,tcpdump,nmap,dns

Homelab: Mastering the Network: Part 5 of 5

Last week, we delved into Firewall Options and Management in Your Homelab, exploring how to secure your network perimeter with effective firewall configurations. We looked at the differences between hardware and software firewalls, rule creation, logging, and common pitfalls to avoid.

This week, we’re pivoting to troubleshooting network issues—a crucial skill for any homelab enthusiast. Even with the best firewall setup, connectivity problems can still arise. This guide will help you systematically diagnose network problems using a range of powerful command-line tools, helping you understand what’s happening beneath the surface.

By applying a structured approach that moves from physical layer checks through IP and DNS verification to application-level testing, and using tools like ping, ping6, traceroute, tcpdump, and nmap, you’ll be better equipped to identify and resolve issues quickly and confidently.

When something in your homelab network stops working, knowing where to start makes all the difference. Whether it’s a service that won’t load, a device that isn’t reachable, or something just acting off—good troubleshooting habits and the right tools can help you get to the bottom of the issue without guesswork.

Start with a Structured Mindset

When something breaks, don’t start by guessing. Start by confirming what does work. This gives you a reference point and keeps you from chasing ghosts. Good troubleshooting is about narrowing down variables, ruling out what’s not the problem, and moving methodically toward the root cause.For a refresher, revisit Routing Basics: Static and Dynamic in the Homelab, which covers key principles that underpin effective troubleshooting.

Here’s a quick method that works well:

  • Confirm the problem exists (don’t rely on assumptions).
  • Reproduce it consistently.
  • Test from different points in the network.
  • Work up the layers: physical → IP → DNS → application.

A Quick OSI Refresher

The OSI model is a seven-layer framework that helps us think clearly about network communication. You don’t have to memorize all the layers—but keeping the general flow in mind helps you avoid skipping steps.

  • Layer 1: Physical – Cables, ports, link lights, NICs.
  • Layer 2: Data Link – MAC addresses, Ethernet, VLAN tagging.
  • Layer 3: Network – IP addressing, routing.
  • Layer 4: Transport – TCP/UDP, ports, sessions.
  • Layer 5–7: Session / Presentation / Application – Services, protocols, DNS, HTTPS, etc.

When debugging, it often helps to start low and work upward. You’d be surprised how many “complex” problems turn out to be unplugged cables or expired DHCP leases.

Using Ping and Ping6 Effectively

ping is one of the simplest yet most powerful tools to test connectivity. It sends ICMP echo request packets and waits for replies, giving you quick feedback on whether a host is reachable and how long packets take to travel.

Here are some examples demonstrating different uses of ping:

Check Internet connectivity:

ping -c 4 8.8.8.8

Sends 4 ICMP echo requests to Google’s DNS server. Success indicates your network can reach the internet.

Test local network reachability:

ping -c 3 192.168.1.1

Pings your local router or gateway. Useful to confirm your LAN is operational.

Continuous ping with timestamp for monitoring:

ping -D 192.168.1.100

This sends continuous pings with timestamps, helpful for long-term monitoring or intermittent issues.

Flood ping for stress testing (use cautiously):

ping -f 192.168.1.100

Sends packets as fast as possible. Great for testing under load but can overwhelm networks and devices.

For IPv6 networks, ping6 works similarly:

Ping an IPv6 address:

ping6 -c 4 2001:4860:4860::8888

Sends 4 echo requests to Google’s IPv6 DNS server.

Ping a local IPv6 address:

ping6 -c 3 fe80::1%eth0

Pings a link-local address on interface eth0. Note the %eth0 scope specifier needed for link-local addresses.

For more on essential Linux commands including ping, see Essential Linux Commands.

Traceroute: Mapping the Path

When ping succeeds but you still have issues accessing certain services, traceroute helps identify where packets are being delayed or dropped along the path.

Example usage:

traceroute google.com

This traces the route packets take to Google’s servers, showing each hop and latency.

For IPv6, use traceroute6 similarly:

traceroute6 google.com

Tcpdump: Capturing Traffic in Detail

When deeper insight is needed, tcpdump lets you capture and analyze network packets in real time.

Basic command capturing packets on interface eth0:

tcpdump -i eth0 -n

Use filters to narrow traffic, e.g., only TCP packets on port 80:

tcpdump -i eth0 tcp port 80 -n

This helps verify if traffic reaches your system or diagnose protocol-level issues.

Learn more about network tools and packet analysis in Mastering Network Tools.

Nmap: Scanning and Auditing Your Network

nmap is invaluable for discovering hosts, open ports, and running services. Use it to check what devices respond on your network and what services they offer.

Simple scan of a subnet:

nmap -sn 192.168.1.0/24

Scan a host for open ports:

nmap 192.168.1.10

For security-focused scanning, see File Auditing and Security Tools.

Conclusion

Effective troubleshooting in your homelab network is both an art and a science. By adopting a structured, layer-by-layer approach and mastering the command-line tools covered here—ping, ping6, traceroute, tcpdump, and nmap—you gain the ability to quickly pinpoint and resolve connectivity problems.

Remember, the key is to work from the ground up: verify physical connectivity, confirm IP addressing and routing, check DNS resolution, and finally test application-level responses. This methodical process minimizes guesswork and builds confidence in your network management skills.

Integrating these tools into your routine helps maintain a healthy homelab environment and equips you to handle unexpected issues with greater ease. Each tool offers unique insights, and together they form a powerful toolkit for network diagnostics.

Keep exploring the resources and guides available at Excalibur’s Heath, and continue building your homelab expertise step-by-step. Your network is only as strong as your ability to understand and troubleshoot it.

More from the "Homelab: Mastering the Network" Series: