Learn Bash base64 Encode and Decode With Examples

Want to learn about 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 used to transmit data over any communication medium by converting the binary data to a text format. This method primarily used for email encryption process. The Base64 method in general is a binary to text encoding scheme which represents an 8-byte binary data to ASCII string format. This has several advantages while transmitting or channeling data among various medium – specially those reliably support text content. Hence, it is widely used in World Wide Web. Probably the most use 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 character – which are easy to transmit and printable. This encoding method uses letter 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

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 command line) or from 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 from any file. It is the default option.
-d or –decodeThis option is used to decode any encoded data from standard input or from 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 character while decoding.
-u or –helpThis option is used to get information about the usage of this command.

Example 1 – A basic encode

In Linux, 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

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 value. The entire set of binary string split into 6 bit binary values which is converted to decimal. Each of the 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 is 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 blow.

Base64 Encode and Decode – inner working

Example 2 – A basic decode

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

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

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 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 user and display 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

Example 6 – A Simple Authentication using base64

Using the above encode and decode method, you can implement a simple authentication system. You can ask user to enter a password or a secret code. Then store the secret code to a file or compare on the fly. If the stored encoded string matches with user input encoded text, then the user is authenticated. Although it is very simple way of checking an authentication, but sometime 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


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