Skip to main content

Command Palette

Search for a command to run...

How to Run Tar.gz File in Linux

Updated
5 min read

Running a tar.gz file in Linux might seem tricky if you’re new to the command line. But don’t worry — I’m here to guide you through the process. Whether you want to extract files or run an application packed inside a tar.gz archive, you’ll find easy steps to follow.

You’ll learn how to handle tar.gz files safely and efficiently. I’ll explain what these files are, how to extract them, and how to run the programs inside. By the end, you’ll feel confident managing tar.gz files on your Linux system.

What is a Tar.gz File?

A tar.gz file is a compressed archive commonly used in Linux. It combines multiple files into one archive and compresses it to save space.

  • Tar stands for "tape archive." It bundles files and folders into a single file.
  • Gz refers to gzip compression, which shrinks the tar archive to reduce its size.

This format is popular for distributing software, backups, and large collections of files. You can think of it like a zip file on Windows but designed for Linux and Unix systems.

How to Extract a Tar.gz File in Linux

Before running any program inside a tar.gz file, you need to extract it. Extraction means unpacking the archive so you can access its contents.

Here’s how to do it:

  1. Open your terminal.
  2. Navigate to the directory containing the tar.gz file using cd.
  3. Run the extraction command:
tar -xzvf filename.tar.gz
  • x tells tar to extract files.
  • z means the archive is compressed with gzip.
  • v stands for verbose, showing the extraction progress.
  • f specifies the filename.

After running this command, you’ll see the files extracted into the current directory or a new folder.

Example

If your file is called example.tar.gz, type:

tar -xzvf example.tar.gz

You’ll get a list of files extracted, ready to use.

Understanding the Extracted Files

Once extracted, you might see different types of files:

  • Source code files (like .c, .cpp, .py)
  • Executable files (binary programs)
  • Scripts (like .sh shell scripts)
  • Documentation (README or INSTALL files)

Look for a README or INSTALL file first. These usually contain instructions on how to run or install the software.

How to Run a Program from a Tar.gz File

Running a program inside a tar.gz file depends on what kind of software it is.

1. Running Precompiled Executables

If the extracted folder contains a ready-to-run executable:

  • Navigate into the extracted directory:
cd extracted-folder
  • List files with ls to find the executable.
  • Run the program by typing:
./program-name

Make sure the file has execute permission. If not, add it with:

chmod +x program-name

2. Running Shell Scripts

If you find a shell script (.sh file), run it like this:

./script-name.sh

Again, ensure it has execute permission.

3. Compiling Source Code

If the tar.gz contains source code, you usually need to compile it before running.

Typical steps:

  • Open the README or INSTALL file for instructions.
  • Common commands include:
./configure
make
sudo make install
  • ./configure prepares the build.
  • make compiles the code.
  • sudo make install installs the program system-wide.

After installation, you can run the program by typing its name in the terminal.

Common Issues and How to Fix Them

Sometimes, running tar.gz files can cause problems. Here are common issues and solutions:

  • Permission denied: Use chmod +x filename to add execute permission.
  • Missing dependencies: Install required packages using your package manager (apt, yum, dnf).
  • Command not found: Make sure you’re in the right directory and use ./ before the program name.
  • Compilation errors: Check the README for prerequisites and install missing libraries.

Tips for Managing Tar.gz Files

Handling tar.gz files becomes easier with these tips:

  • Always extract files in a dedicated folder to avoid clutter.
  • Use tar -tzvf filename.tar.gz to list contents without extracting.
  • Keep your system updated to avoid compatibility issues.
  • Use graphical archive managers if you prefer not to use the terminal.

Summary Table of Commands

TaskCommandDescription
Extract tar.gztar -xzvf filename.tar.gzExtract files from tar.gz archive
List contents without extractingtar -tzvf filename.tar.gzView files inside the archive
Change directorycd folder-nameMove into extracted folder
Make file executablechmod +x filenameAdd execute permission
Run executable./program-nameRun a program or script
Compile source code./configure && make && sudo make installBuild and install software

Conclusion

Now you know how to run tar.gz files in Linux. First, extract the archive using the tar command. Then, check the extracted files to see if you can run an executable or need to compile source code.

Remember to look for README files for specific instructions. With these steps, you’ll handle tar.gz files confidently, whether you’re installing software or exploring new programs. Keep practicing, and soon it will feel like second nature.


FAQs

How do I know if a tar.gz file contains a program or just files?

Check the contents by extracting or listing with tar -tzvf filename.tar.gz. Look for executables, scripts, or source code folders. README files often explain what’s inside.

Can I run a tar.gz file without extracting it?

No, you must extract the tar.gz archive first to access and run its contents.

What if I get a "permission denied" error when running a program?

Use chmod +x filename to add execute permission. This allows the system to run the file.

How do I install software from a tar.gz file?

Extract it, then follow instructions in README or INSTALL files. Usually, you run ./configure, make, and sudo make install to build and install.

Is tar.gz the same as zip files?

Both compress files, but tar.gz is common in Linux and combines archiving and compression separately, while zip compresses and archives in one step.

More from this blog

L

LinuxBloke | Linux Tips, Tricks & Troubleshooting

672 posts