Learn Bash base64 Encode and Decode With Examples

4 min

Want to learn about the base64 encode and decode method? Here in this tutorial, we explain the base64 encode and decode steps using bash shell scripting with various examples.

The base64 encoding method transmits data over any communication medium by converting binary data to text. This method is primarily used for the email encryption process.

The Base64 method, in general, is a binary-to-text encoding scheme representing 8-byte binary data in ASCII string format. This has several advantages while transmitting or channelling data among various mediums – especially those that reliably support text content. Hence, it is widely used on World Wide Web. Probably the most used case of this encoding scheme is using it for email attachments.

As per the Base64 representation table, the binary data can be converted to 64 different ASCII characters – which are easy to transmit and printable. This encoding method uses letters A to Z, a to Z, 0 to 9 and + and /.

A total of 64 ASCII characters to represent binary from 000000 to 111111. Each non-final Base64 digit represents exactly 6 bits of data.

Base64 Index Table
Base64 Index Table

Bash base64 encode and decode


Before you learn about the examples, here is the basic syntax.


Option: You can provide any of the options or combine them as explained below.
INFILE: Input can be picked up from standard input (like the command line) or files.
OUTFILE: You can redirect the output to the standard output, like the terminal or to a file.

-e or –encodeThis option is used to encode any data from standard input or any file. It is the default option.
-d or –decodeThis option is used to decode any encoded data from standard input or any file.
-n or –noerrcheckBy default, base64 checks error while decoding any data. You can use –n or –noerrcheck option to ignore checking at the time of decoding.
-i, –ignore-garbageThis option is used to ignore non-alphabet characters while decoding.
-u or –helpThis option is used to get information about the usage of this command.

Example 1 – A basic encode

In Linux, the base64 package is installed by default. Hence, you can use it from the command line easily. To simply encode a string or text, you can pass it through the command line via piping and get the encoded text. In this example, the string debugpoint.com is encoded to base64.

echo "debugpoint.com" | base64
bash base64 encode and decode - example 1
bash base64 encode and decode – example 1

The result is the base64 encoded string.


The encoding method uses several steps to convert the input. The input characters are converted to 8-bit binary values. The entire set of the binary string is split into 6-bit binary values, which are converted to decimals.

Each decimal value is translated to the base64 character via the base64 index table.

In the above example, the first character, “d”, is converted to binary 01100100. The first 6 bits are 011001, which is 25 in decimal. The 25 refers to the Z in the base64 index table. And this goes on for the entire stream of text. See the example below.

Base64 Encode and Decode - inner working
Base64 Encode and Decode – inner working

Example 2 – A basic decode

To decode the string, simply pass the encoded value to the base64 with the option --decode. And it will give you the exact input string.

bash base64 encode and decode - example 2 (decode the same example)
bash base64 encode and decode – example 2 (decode the same example)

Example 3 – Encode a Text file

The same command can be used to encode a text file and redirect the output to another text file. Here’s how.

base64 example3.txt > example3-encoded.txt
Encode a text file
Encode a text file

Example 4 – Decode a Text File

And to decode a text file that was encoded using base64, simply use the --decode or -d switch and pass on the text file name.

base64 -d example3-encoded.txt

Example 5 – Encode a custom input from the user

Using bash shell programming, you can take input from the user via the terminal and encode it. But for that, you need to write a simple shell script and execute it after giving executable permission.

Here’s a simple example which takes input from the user and displays the encoded string.

#Sample program to take input, encode to base64 and display on terminal
#Example by www.debugpoint.com
echo "Enter text for encoding to base64:"
read input_text
output_text=`echo -n $input_text | base64`
echo "The Base64 Encoded text is: $output_text"
Custom input - base64 encode and decode using script
Custom input – base64 encode and decode using script

Example 6 – A Simple Authentication using base64

You can implement a simple authentication system using the above encode and decode method. You can ask the user to enter a password or a secret code. Then store the secret code in a file or compare it on the fly.

If the stored encoded string matches with the user input encoded text, then the user is authenticated. However, it is a straightforward way of checking an authentication, but sometimes useful for simple business cases.

#Sample program to take input, encode to base64 and display on terminal
#Example by www.debugpoint.com
echo "Type your password"
read pwd1
decoded_text=`echo 'U2lsZW5jZSBpcyBnb2xkZW4h' | base64 --decode`
if [[ $pwd1 == $decoded_text ]]
    echo "You are a valid user."
    echo "You are NOT a valid user."
A Simple Authentication using bash base64
A Simple Authentication using bash base64


I hope you get to learn the basics of Base64 encode and decode with these examples. Also, learn a bit about its inner workings. Let me know in the comment box below if this helps you or need additional tutorials on this topic.


Creator and author of debugpoint.com. Connect with me via Telegram, 𝕏 (Twitter), or send us an email.
Notify of

This site uses Akismet to reduce spam. Learn how your comment data is processed.

1 Comment
Oldest Most Voted
Inline Feedbacks
View all comments