Search our site for answers
Help Docs Server Administration Linux Server Administration How to Use Grep

How to Use Grep

Learn grep to quickly search files on your server. Find text in logs, configs, or code easily, saving time managing your hosting environment!
SSH
5 min read

If you manage a website or server with your web hosting account, you’ll often need to search through files—like logs, configuration files, or even your website’s code. This is where grep, a powerful command-line tool, comes in handy. Available on Linux-based servers, grep helps you quickly find specific text within files. In this article, we’ll explain what grep is, how it can help you, and show you a few simple ways to use it.

What is grep?

Grep stands for Global Regular Expression Print. It’s a tool that searches for text patterns in files and displays lines that match your search. Think of it like the “Find” function in a text editor, but much more powerful and designed for use in the command line (like your hosting server’s terminal or SSH access).

Grep is especially useful for tasks like:

  • Searching error logs to troubleshoot website issues.
  • Finding specific settings in configuration files.
  • Locating text in your website’s code or content.

Getting started with grep

To use grep, you’ll need access to your server’s command line, typically via SSH. Once you’re logged in, you can run grep commands.

The basic syntax is:

grep [flags] "search term" filename
  • flags: Optional settings to modify how grep works.
  • search term: The text or pattern you’re looking for.
  • filename: The file (or files) you want to search.

Let’s explore a few common flags and examples tailored to web hosting tasks.

Common grep flags and examples

Here are three of the most commonly used grep flags, with examples relevant to managing your hosted website or server.

Grep is case-sensitive by default. The -i flag makes grep ignore whether letters are uppercase or lowercase. This is great when you’re not sure about the exact case of the text you’re searching for.

Example: Suppose you want to find all instances of the word “error” (whether it’s “Error”, “ERROR”, or “eRrOr”) in your website’s error log file, error.log.

grep -i "error" error.log

Output (example):

[2025-05-20] Error: Database connection failed
[2025-05-21] ERROR: File not found

This command shows all lines containing “error” in any case, helping you spot issues in your logs.

Use Case: Use -i when searching logs or configuration files where capitalization might vary, like Apache or PHP error logs.

The -r flag tells grep to search all files in a directory and its subdirectories. This is perfect for searching through your entire website’s codebase or multiple log files.

Example: Imagine you want to find where the phrase “contact form” appears in your website’s files, stored in the /public_html directory.

grep -r "contact form" /public_html

Output (example):

/public_html/index.html:    <h2>Contact Form</h2>
/public_html/scripts/form.php:    // Process contact form submission

This shows the file paths and lines where “contact form” appears, making it easy to locate relevant code.

Use Case: Use -r to search across all your website files, like HTML, PHP, or JavaScript, to find specific text or code snippets.

-n: Show line numbers

The -n flag displays the line number of each matching line in the file. This is helpful when you need to pinpoint exactly where a match occurs, especially in large files.

Example: You’re troubleshooting a configuration file, wp-config.php, and want to find where the database name is defined.

grep -n "DB_NAME" wp-config.php

Output (example):

25:define('DB_NAME', 'mywebsite_db');

This tells you the database name is defined on line 25, so you can quickly navigate to that line in a text editor.

Use Case: Use -n when editing configuration files (e.g., WordPress’s wp-config.php or .htaccess) to locate settings precisely.

Combining flags

You can combine flags to make grep even more powerful. For example, to search recursively (-r), case-insensitively (-i), and show line numbers (-n), you could use:

grep -rin "error" /var/log

This command searches all log files in /var/log for “error” (in any case) and shows the file, line number, and matching line. This is incredibly useful for debugging server issues.

Tips for using grep

  • Be specific with search terms: Narrow your search to avoid too many results. For example, use “404 error” instead of just “error” when looking for specific HTTP errors.
  • Use quotes for phrases: Always put your search term in quotes if it contains spaces (e.g., “contact form”).

Next steps

Ready to try grep? Log in to your server via SSH and experiment with the examples above. Start with simple searches on log files or your website’s files. As you get comfortable, you can explore more advanced grep features, like regular expressions, to unlock even more power.

If you need help accessing your server or have questions about your hosting environment, we’re happy to help, just reach out to our support team.

Happy searching!

Was this article helpful?