The Bash Guide

A quality-driven guide through the shell's many features.

This guide is an introduction to basic and advanced concepts of the bash shell.

It teaches both newcomers and long-time users the best, safest and most robust ways of writing powerful bash scripts as well as making efficient and speedy interactive use of the shell.

This guide has gone through several iterations and is the result of a severe lack of consistent, clear and reliable language on the topic on the rest of the Internet as well as the public library or book stores.


The primary author and maintainer of this guide is lhunath (Maarten Billemont).

This guide is open source, licensed under Creative Commons Attribution-ShareAlike 4.0 International License (CC-BY-SA). The source code is available at GitHub. Go there to report issues or fork the guide to contribute changes (big or small). To keep up to date with new chapters or improvements to this guide, you could star the GitHub project.

For advice, comments, suggestions, corrections or recommendations, contact lhunath, file an issue or visit the #bash community on IRC.

This guide is an active work in progress. New chapters are being written and existing chapters are continuously being updated and improved.

Using this guide, I am sharing my knowledge and expertise with the world freely in the hopes of benefitting you and all others like you. If you've benefitted from the knowledge and experience gained through this guide, consider "giving back" to encourage a society of open access and freedom of information. You can give back by providing feedback on the guide at the GitHub project page, making corrections by hitting the edit buttons on the chapter pages, sharing this guide with any of your friends that have similar interests so that they too may learn as you have, or contributing financially in gratitude for my work, time and effort put into writing and maintaining this guide.

I would like to pay for the benefit of my access to this guide:

Creative Commons License


After introducing new practical concepts, the guide offers a set of exercises to allow you to practice your new knowledge. For a summary of all exercises in this guide, see our exercises index.


  1. Inceptionbeta: What is bash, and where does it live?

    An introduction to bash, installing and starting it; the terminal, the keyboard and the display; programs, processes and how their flow of information is connected.

  2. Commands And Argumentsbeta: How do I give bash instructions?

    About what a command is, and how to issue them; interactive mode and scripts; command syntax, searching commands and programs by name; arguments and word splitting as well as input and output redirection.

  3. Variables and Expansionsalpha: How do I store and work with data?

    Bash parameters and variables; environment variables, special parameters and array parameters; expanding parameters, expansion operators, command substitution and process substitution; pathname expansion, tilde expansion and brace expansion.

  4. Tests And Conditionalsdraft: Different commands for different data.

    Exit codes, success and failure, testing files, strings and numbers, handling different conditions, conditional operators and conditional compound commands.

  5. Loops And Functionstodo: Avoid repeating yourself.

    Iterating commands using for loops, while and until loops, select statements and grouping them in functions.

  6. Asynchronous Commandstodo: Doing work in the background and managing jobs.

    About jobs, asynchronous commands, job control, process identifiers and signals, process management, inter-process communications.

  7. Colors And Terminal Commandstodo: Advanced control over the terminal display.

    Terminals and terminal sequences, terminal identifiers, terminfo and terminal capabilities, outputting colors, moving the cursor and querying the terminal's state.

  8. Customizing The Prompttodo: Changing the look and feel of the interactive shell.

    Prompting, prompt commands and the DEBUG signal, readline, bind and input modes and hotkeys, programmatic command completion.

  9. Advanced Topicstodo: About syntax sugar, specific use cases and shell tricks.

  10. Recommendations And Pitfallstodo: How to do things well and how to do things very, very badly.

  11. Noteworthy External Toolstodo: Bash is limited, but augmented by a powerful toolset.

Fork me on GitHub