I received a huge .tar.gz file from a client that contains about 800 mb of image files (when uncompressed.) Our hosting company's ftp is seriously slow, so extracting all the files locally and sending them up via ftp isn't practical. I was able to ftp the .tar.gz file to our hosting site, but when I ssh into my directory and try using unzip, it gives me this error:

[esthers@clients locations]$ unzip community_images.tar.gz
Archive:  community_images.tar.gz
  End-of-central-directory signature not found.  Either this file is not a zipfile, or it constitutes one disk of a multi-part archive.  In the latter case the central directory and zipfile comment will be found on the last disk(s) of this archive.
note:  community_images.tar.gz may be a plain executable, not an archive
unzip:  cannot find zipfile directory in one of community_images.tar.gz or community_images.tar.gz.zip, and cannot find community_images.tar.gz.ZIP, period.

What command do I need to use to extract all the files in a .tar.gz file?

up vote 1133 down vote accepted

Type man tar for more information, but this command should do the trick:

tar -xvzf community_images.tar.gz

To explain a little further, tar collected all the files into one package, community_images.tar. The gzip program applied compression, hence the gz extension. So the command does a couple things:

  • f: this must be the last flag of the command, and the tar file must be immediately after. It tells tar the name and path of the compressed file.
  • z: tells tar to decompress the archive using gzip
  • x: tar can collect files or extract them. x does the latter.
  • v: makes tar talk a lot. Verbose output shows you all the files being extracted.
  • 4
    @Shiki I saw your proposed edit. I don't think it's an appropriate change, I prefer the way I explained this tool. I do think your tar -xf suggestion would make a great additional answer. – djeikyb Dec 2 '13 at 18:05
  • 3
    This is one of the better explanations out of the millions of similarly phrased questions – JohnMerlino Oct 5 '14 at 14:48
  • 1
    @KasunSiyambalapitiya By default, ends up in the current folder. See also man tar; look for the -C option. Or maybe check out the other answer 😉 – djeikyb Nov 7 '16 at 14:58
  • 1
    @nikoss i add the v switch all the time because i like seeing the file listing during extraction. teaching this also prepares the reader for other tar commands like tar -tvf foo.tar which displays the archive contents without extracting. – djeikyb Nov 9 '16 at 16:43
  • 3
    Reminds me of xckd's article about tar. I have to come back every time. – mgarey Oct 3 '17 at 22:25

If you want the files to be extracted to a particular destination you can add -C /destination/path/
Make sure you make the directory first, in this case: ~/Pictures/Community

Example:

mkdir ~/Pictures/Community
tar xf community_images.tar.gz -C /home/emmys/Pictures/Community/

You can easily memorize it if you consider telling tar to e X tract a F ile

gif of process done at terminal

Note: Remember you can search inside man pages with ?+term to look for, and then n and N to go to the next or previous instance of the term you are looking for.

  • 4
    don't forget C for "change directory"! also, i feel it's better not to mix hyphen and non-hyphen options (especially confusing when using ps). – djeikyb Nov 5 '14 at 23:45
  • 1
    Why is it not -o like every other command ever? – Jan M. Mar 1 '17 at 13:57
  • 1
    I love your hint 'tar to e X tract a F ile' – Nam G VU Nov 13 '17 at 7:11
  • 1
    1+ for the animated gif – Nick Steele Sep 4 at 1:18

At some point tar was upgraded to auto-decompress. All you need now is:

tar xf community_images.tar.gz

The same explanation applies:

  • f: this must be the last flag of the command, and the tar file must be immediately after. It tells tar the name and path of the compressed file.
  • x: extract the files.

Note the lack of hyphen for the command flags. This is because most versions of tar allow both gnu and bsd style options (simplistically, gnu requires a hyphen, bsd doesn't).

  • 1
    Is there any documentation on this? I've been searching all over for a reference to this, I never use the -z flag and everything gets gzipped so I've been worried if I haven't been compressing my tarballs at all, haha. Thanks. – neurosnap Jul 10 '15 at 4:14
  • 2
    @neurosnap see the gnu manual and of the bsd's manual – djeikyb Jul 12 '15 at 20:49
  • 3
    Probably would have been better to edit your original answer. – Seth Jun 9 '16 at 18:04
  • 3
    @Seth it feels/felt distinct enough to be a separate answer, especially in context of the destructive edit that provoked it. I'll rethink it after work though, might be a simpler way to merge than I originally thought. – djeikyb Jun 9 '16 at 18:23
  • 1
    @EnricoMariaDeAngelis bsd tar since at least 2004 and gnu tar since at least 2010 have supported auto-selecting a decompressor. it's possible no "recent" (this century? nineties+?) version of tar requires manually selecting a decompressor. – djeikyb Jun 2 '17 at 4:39

In case you are not able to extract .tar.gz file using

tar -xvzf fileName.tar.gz

Try extracting using

tar xf fileName.tar.gz
  • 3
    if it is a gzipped tar file, the first command will always work. if it does not work, you do not have a gzipped tar file. the latter command is a great recommendation for folks who don't care what compression algorithm was used on their tar file. – djeikyb Mar 9 '17 at 2:37

Remembering all flags for tar can be tedious. Obligatory XKCD:

enter image description here

Therefore I made my own little script in Python to do that. Quick, dirty, cp-like in usage:

#!/usr/bin/env python3
import tarfile,sys,os
tf = tarfile.open(name=sys.argv[1],mode='r:gz')
where = '.'
if len(sys.argv) == 3:
    where = sys.argv[2]
tf.extractall(path=where)
tf.close()

Use it as so:

myuntar.py archive.tar

See also similar script for unzipping zip archives.

  • 1
    :) only two tar flags to remember -caf for creating based on the filename and -xf for extracting (AFAIK works on every type of tar). – Videonauth Sep 20 at 7:31
  • @Videonauth I know, it's not that complex, but for some reason I never remember these options. Maybe because I don't deal with archives often enough. – Sergiy Kolodyazhnyy Sep 20 at 7:33

Quick Answer:

tar -xvf  <.tar file> or <.tar.xz file>
tar -xzvf <.tar.gz file>
tar -xjvf <.tar.bz2 file>

[NOTE]:

  • -v Verbosely list files processed.
  • -z Filter the archive through gzip.
  • -f Use archive file or device ARCHIVE.
  • -x Extract files from an archive.
  • -j bzip2.
  • tar -xf archive.tar # Extract all files from archive.tar.

You could do this too in first step:

gunzip community_images.tar.gz

Then you have the file: community_images.tar

Second step would be:

tar -xvf community_images.tar

And the *.tar file would be extracted.

protected by Community Oct 27 '17 at 4:47

Thank you for your interest in this question. Because it has attracted low-quality or spam answers that had to be removed, posting an answer now requires 10 reputation on this site (the association bonus does not count).

Would you like to answer one of these unanswered questions instead?

Not the answer you're looking for? Browse other questions tagged or ask your own question.