Skip to content

Instantly share code, notes, and snippets.

@grahamperrin
Last active April 22, 2025 11:24
Show Gist options
  • Save grahamperrin/14df6b17520e6c611381c0faeb43a25f to your computer and use it in GitHub Desktop.
Save grahamperrin/14df6b17520e6c611381c0faeb43a25f to your computer and use it in GitHub Desktop.
General troubleshooting advice for FreeBSD

Seeking the best unofficial resources

I fed a forty-word paragraph to Google Gemini 2.5 Pro (Experimental) on the evening of Sunday 20th April. Twenty of the forty:

Where can I find general troubleshooting advice for FreeBSD? Emphasis on: general. … I'm looking for the best unofficial resources. Thanks.

Gemini offered a 508-word response. I:

  1. reduced it to around 330 (not counting * or as words)
  2. added a link to the third edition (2018) of Absolute FreeBSD
  3. add a direct link to the FreeBSD tips page
  4. added a link to the freebsd-questions mailing list
  5. added GitHub links for the two UPDATING files – note that your local copies may be different.

Gemini's response (condensed)

… the official FreeBSD Handbook and FAQ are excellent resources, … the FreeBSD community is very active, …

… some of the best unofficial resources for general FreeBSD troubleshooting:

  1. The FreeBSD Forums

    • troubleshooting tag …
    • … provide details like error messages, logs, hardware configuration, and what steps you've already tried.
  2. r/freebsd

    • … Users often recommend books like Absolute FreeBSD for deeper understanding, which inherently aids troubleshooting.
  3. Blogs and personal websites

    • … technical articles, including guides on network performance troubleshooting and comparing FreeBSD/Linux troubleshooting tools (top, gcore, procstat, etc.)
    • FreeBSD tips ….
  4. Mailing lists

General troubleshooting approaches gathered from these resources

Check the logs:

  • always start by examining system logs like /var/log/messages and relevant application logs
  • tools like dmesg are also essential after boot or hardware changes.

Verbose booting:

  • if you have boot issues, try booting in verbose mode to see detailed kernel messages.

Isolate the problem:

  • try to determine if the issue is related to hardware, a specific software package, network configuration, a recent update, or system configuration.

Hardware checks:

  • ensure your hardware is supported and configured correctly (check BIOS/UEFI settings, IRQs, etc.)
  • sometimes, simple things like replacing an IDE cable can fix disk errors.

Use system utilities:

  • become familiar with standard FreeBSD tools like top (to check CPU, memory, I/O usage), ps, sockstat, netstat, vmstat, iostat, sysctl, ping, and traceroute.

Read UPDATING:

Simplify:

  • if possible, temporarily remove hardware or disable services to see if the problem persists, helping narrow down the cause.

Baseline performance:

  • for performance issues, try to establish what "normal" performance looks like for your system before trying to diagnose deviations.

By combining searching the forums and Reddit, reading relevant blog posts, and applying standard troubleshooting techniques, you should be able to tackle most general FreeBSD problems.

@grahamperrin
Copy link
Author

troubleshooting tag

  • eleven posts over a period of maybe seven or ten years
  • one of the eleven is solved.

Related:

Discussion of the 2018 upgrade, after the event:

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment