CINXE.COM

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"> <html lang="en"> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8"> <title> Downloading Debian USB/CD/DVD images with jigdo </title> <link rel="author" href="mailto:webmaster@debian.org"> <meta name="Generator" content="WML 2.32.0"> <meta name="Modified" content="2024-11-09 23:26:37"> <meta name="viewport" content="width=device-width"> <meta name="mobileoptimized" content="300"> <meta name="HandheldFriendly" content="true"> <link href="../../debian.css" rel="stylesheet" type="text/css"> <link href="../../debian-en.css" rel="stylesheet" type="text/css" media="all"> <link rel="search" type="application/opensearchdescription+xml" title="Debian website search" href="../../search.en.xml"> </head> <body> <div id="header"> <div id="upperheader"> <div id="logo"> <a href="../../" title="Debian Home"><img src="../../Pics/openlogo-50.png" alt="Debian" width="50" height="61"></a> </div>  <div id="searchbox"> <form name="p" method="get" action="https://search.debian.org/cgi-bin/omega"> <p> <input type="hidden" name="DB" value="en"> <input name="P" value="" size="14"> <input type="submit" value="Search"> </p> </form> </div>  </div>   <div id="navbar"> <p class="hidecss"><a href="#content">Skip Quicknav</a></p> <ul>  <li><a href="https://bits.debian.org/" title="Bits from Debian">Blog</a></li> <li><a href="https://micronews.debian.org" title="Micronews from Debian">Micronews</a></li> <li><a href="https://planet.debian.org/" title="The Planet of Debian">Planet</a></li> </ul> </div>  <p id="breadcrumbs"><a href="../">Debian installation media for USB, CD, DVD</a> / Downloading Debian USB/CD/DVD images with jigdo</p> </div>   <div id="content"> <div id="second-nav">  <p><a href="../../CD/">Debian on CD</a></p> <ul class="cdmenu"> <li><a href="../../CD/faq/">FAQ</a></li> <li><a href="../../CD/netinst/">Network Install</a></li> <li><a href="../../CD/live/">Live images</a></li> <li><a href="../../CD/vendors/">Buy CDs or DVDs</a></li> <li>Download <ul> <li><a href="../../CD/http-ftp/">Download via HTTP/FTP</a></li> <li><a href="../../CD/torrent-cd/">Download with Torrent</a></li> <li><a href="../../CD/jigdo-cd/">Download with Jigdo</a></li> <li><a href="../../CD/mirroring/rsync-mirrors">Rsync Mirrors</a></li> <li><a href="../../CD/verify">Verify</a></li> </ul> </li> </ul>  </div>  <div id="maincol"> <h1>Downloading Debian USB/CD/DVD images with jigdo</h1> <p>Jigsaw Download, or short <a href="https://www.einval.com/~steve/software/jigdo/">jigdo</a>, is a bandwidth-friendly way of distributing Debian USB/CD/DVD images.</p> <ul class="toc"> <li><a href="#why">Why jigdo is better than a direct download</a></li> <li><a href="#how">How to download an image with jigdo</a></li> <li><a href="#which">Official images</a></li> <li><a href="#search">Search Contents of USB/CD/DVD images</a></li> <li><a href="#faq">Frequently Asked/Answered Questions</a></li> </ul> <h2><a name="why" id="why">Why jigdo is better than a direct download</a></h2> <p>Because it is faster! For various reasons, there are far fewer mirrors for USB/CD/DVD images than there are for the "normal" Debian archive. Consequently, if you download from a USB/CD/DVD image mirror, that mirror will not only be further away from you, it will also be overloaded, especially just after a release.</p> <p>Furthermore, some types of images are not available as full <tt>.iso</tt> downloads because there is not enough space on our servers to host them.</p> <p>Of course, a "normal" Debian mirror does not carry any USB/CD/DVD images, so how can jigdo download them there? jigdo achieves this by downloading individually all the files that are on the USB/CD/DVD. In the next step, all these files are assembled in one big file which is an exact copy of the USB/CD/DVD image. However, all this happens behind the scenes - all that <em>you</em> need to do is tell the download tool the location of a "<tt>.jigdo</tt>" file to process.</p> <p>More information is available from the <a href="https://www.einval.com/~steve/software/jigdo/">jigdo homepage</a>. Volunteers willing to help with jigdo development are always welcome!</p> <h2><a name="how" id="how">How to download an image with jigdo</a></h2> <ul> <li>Download a package containing <tt>jigdo-lite</tt>. This is available directly for installation in the Debian and Ubuntu distributions in the <tt>jigdo-file</tt> package. For FreeBSD, install from /usr/ports/net-p2p/jigdo or grab the package with <tt>pkg_add -r jigdo</tt>. For other installation options (binaries for Windows, source), check the the <a href="https://www.einval.com/~steve/software/jigdo/">jigdo homepage</a>. </li> <li>Run the <tt>jigdo-lite</tt> script. It will ask for the URL of a "<tt>.jigdo</tt>" file to process. (You can also supply that URL on the command line if you like.)</li> <li>From one of the locations listed <a href="#which">below</a>, pick the "<tt>.jigdo</tt>" files you want to download, and enter their URLs at the <tt>jigdo-lite</tt> prompt. Each "<tt>.jigdo</tt>" file corresponds to one "<tt>.iso</tt>" USB/CD/DVD image.</li> <li>If you are a first-time user, just press Return at the "Files to scan" prompt.</li> <li>At the prompt "Debian mirror", enter either <kbd>http://deb.debian.org/debian/</kbd> or <kbd>http://ftp.<strong><var>XY</var></strong>.debian.org/debian/</kbd>, where <strong><var>XY</var></strong> is the two-letter code for your country (for example, <tt>us</tt>, <tt>de</tt>, <tt>uk</tt>. See the current list of <a href="../../mirror/list">available ftp.<var>XY</var>.debian.org locations</a>.) <li>Follow the instructions printed by the script. If all goes well, the script finishes by calculating a checksum of the generated image and telling you that the checksum matches that of the original image.</li> </ul> <p>For a detailed, step-by-step description of this process, have a look at the <a href="https://tldp.org/HOWTO/Debian-Jigdo/">Debian jigdo mini-HOWTO</a>. The HOWTO also explains jigdo's advanced features, such as upgrading an older version of a USB/CD/DVD image to the current version (by downloading only what has changed, not the entire new image).</p> <p>Once you have downloaded the images and written them to USB/CD/DVD, be sure to have a look at the <a href="../../releases/stable/installmanual">detailed information about the installation process</a>.</p> <h2><a name="which" id="which">Official images</a></h2> <h3>Official jigdo files for the <q>stable</q> release</h3> <div class="line"> <div class="item col50"> <p><strong>CD/USB</strong></p> <div class="downloads"><ul class="downlist"><li><a href="https://cdimage.debian.org/debian-cd/current/amd64/jigdo-cd/">amd64</a></li><li><a href="https://cdimage.debian.org/debian-cd/current/arm64/jigdo-cd/">arm64</a></li><li><a href="https://cdimage.debian.org/debian-cd/current/armel/jigdo-cd/">armel</a></li><li><a href="https://cdimage.debian.org/debian-cd/current/armhf/jigdo-cd/">armhf</a></li><li><a href="https://cdimage.debian.org/debian-cd/current/i386/jigdo-cd/">i386</a></li><li><a href="https://cdimage.debian.org/debian-cd/current/mips64el/jigdo-cd/">mips64el</a></li><li><a href="https://cdimage.debian.org/debian-cd/current/mipsel/jigdo-cd/">mipsel</a></li><li><a href="https://cdimage.debian.org/debian-cd/current/ppc64el/jigdo-cd/">ppc64el</a></li><li><a href="https://cdimage.debian.org/debian-cd/current/s390x/jigdo-cd/">s390x</a></li></ul></div> </div> <div class="item col50 lastcol"> <p><strong>DVD/USB</strong></p> <div class="downloads"><ul class="downlist"><li><a href="https://cdimage.debian.org/debian-cd/current/amd64/jigdo-dvd/">amd64</a></li><li><a href="https://cdimage.debian.org/debian-cd/current/arm64/jigdo-dvd/">arm64</a></li><li><a href="https://cdimage.debian.org/debian-cd/current/armel/jigdo-dvd/">armel</a></li><li><a href="https://cdimage.debian.org/debian-cd/current/armhf/jigdo-dvd/">armhf</a></li><li><a href="https://cdimage.debian.org/debian-cd/current/i386/jigdo-dvd/">i386</a></li><li><a href="https://cdimage.debian.org/debian-cd/current/mips64el/jigdo-dvd/">mips64el</a></li><li><a href="https://cdimage.debian.org/debian-cd/current/mipsel/jigdo-dvd/">mipsel</a></li><li><a href="https://cdimage.debian.org/debian-cd/current/ppc64el/jigdo-dvd/">ppc64el</a></li><li><a href="https://cdimage.debian.org/debian-cd/current/s390x/jigdo-dvd/">s390x</a></li><li><a href="https://cdimage.debian.org/debian-cd/current/source/jigdo-dvd/">source</a></li></ul></div> </div> <div class="clear"></div> </div> <div class="line"> <div class="item col50"> <p><strong>Blu-ray</strong></p> <div class="downloads"><ul class="downlist"><li><a href="https://cdimage.debian.org/debian-cd/current/i386/jigdo-bd/">i386</a></li><li><a href="https://cdimage.debian.org/debian-cd/current/amd64/jigdo-bd/">amd64</a></li><li><a href="https://cdimage.debian.org/debian-cd/current/source/jigdo-bd/">source</a></li></ul></div> </div> </div> <p>Be sure to have a look at the documentation before you install. <strong>If you read only one document</strong> before installing, read our <a href="../../releases/stable/amd64/apa">Installation Howto</a>, a quick walkthrough of the installation process. Other useful documentation includes: </p> <ul> <li><a href="../../releases/stable/installmanual">Installation Guide</a>, the detailed installation instructions</li> <li><a href="https://wiki.debian.org/DebianInstaller">Debian-Installer Documentation</a>, including the FAQ with common questions and answers</li> <li><a href="../../releases/stable/debian-installer/#errata">Debian-Installer Errata</a>, the list of known problems in the installer</li> </ul> <h3>Official jigdo files for the <q>testing</q> distribution</h3> <div class="line"> <div class="item col50"> <p><strong>CD/USB</strong></p> <div class="downloads"><ul class="downlist"><li><a href="https://cdimage.debian.org/cdimage/weekly-builds/amd64/jigdo-cd/">amd64</a></li><li><a href="https://cdimage.debian.org/cdimage/weekly-builds/arm64/jigdo-cd/">arm64</a></li><li><a href="https://cdimage.debian.org/cdimage/weekly-builds/armel/jigdo-cd/">armel</a></li><li><a href="https://cdimage.debian.org/cdimage/weekly-builds/armhf/jigdo-cd/">armhf</a></li><li><a href="https://cdimage.debian.org/cdimage/weekly-builds/mips64el/jigdo-cd/">mips64el</a></li><li><a href="https://cdimage.debian.org/cdimage/weekly-builds/ppc64el/jigdo-cd/">ppc64el</a></li><li><a href="https://cdimage.debian.org/cdimage/weekly-builds/s390x/jigdo-cd/">s390x</a></li></ul></div> </div> <div class="item col50 lastcol"> <p><strong>DVD/USB</strong></p> <div class="downloads"><ul class="downlist"><li><a href="https://cdimage.debian.org/cdimage/weekly-builds/amd64/jigdo-dvd/">amd64</a></li><li><a href="https://cdimage.debian.org/cdimage/weekly-builds/arm64/jigdo-dvd/">arm64</a></li><li><a href="https://cdimage.debian.org/cdimage/weekly-builds/armel/jigdo-dvd/">armel</a></li><li><a href="https://cdimage.debian.org/cdimage/weekly-builds/armhf/jigdo-dvd/">armhf</a></li><li><a href="https://cdimage.debian.org/cdimage/weekly-builds/mips64el/jigdo-dvd/">mips64el</a></li><li><a href="https://cdimage.debian.org/cdimage/weekly-builds/ppc64el/jigdo-dvd/">ppc64el</a></li><li><a href="https://cdimage.debian.org/cdimage/weekly-builds/s390x/jigdo-dvd/">s390x</a></li><li><a href="https://cdimage.debian.org/cdimage/weekly-builds/source/jigdo-dvd/">source</a></li></ul></div> </div> </div> <hr> <h2><a name="search" id="search">Search Contents of USB/CD/DVD images</a></h2> <p><strong>Which USB/CD/DVD image contains a certain file?</strong> Below, you can search the lists of files contained in a wide variety of Debian USB/CD/DVD images. You can enter several words, each word must match a substring of the filename. Add e.g. "_i386" to restrict the results to a certain architecture. Add "_all" to see packages which are identical for all architectures.</p> <form method="get" action="https://cdimage-search.debian.org/"><p> <input type="hidden" name="search_area" value="release"> <input type="hidden" name="type" value="simple"> <input type="text" name="query" size="20" value=""> <input type="submit" value="Search"></p></form> <p><strong>What files are contained in a certain image?</strong> If you need a list of <em>all</em> files that a certain Debian USB/CD/DVD contains, just look in the image's corresponding <tt>list.gz</tt> file on <a href="https://cdimage.debian.org/cdimage/">cdimage.debian.org</a>.</p> <hr> <h2><a name="faq" id="faq">Frequently Asked/Answered Questions</a></h2> <p><strong>How do I make jigdo use my proxy?</strong></p> <p>Load the file <tt>~/.jigdo-lite</tt> (or <tt>jigdo-lite-settings.txt</tt> for the Windows version) into a text editor and find the line that starts with "wgetOpts". The following switches can be added to the line:</p> <p><tt>-e ftp_proxy=http://<i>LOCAL-PROXY</i>:<i>PORT</i>/</tt> <br><tt>-e http_proxy=http://<i>LOCAL-PROXY</i>:<i>PORT</i>/</tt> <br><tt>--proxy-user=<i>USER</i></tt> <br><tt>--proxy-passwd=<i>PASSWORD</i></tt></p> <p>Of course, substitute the correct values for your proxy server. The last two options are only necessary if your proxy uses password authentication. The switches need to be added to the end of the wgetOpts line <em>before</em> the final <tt>'</tt> character. All options must be on one line.</p> <p>Alternatively, under Linux you can also set up the <tt>ftp_proxy</tt> and <tt>http_proxy</tt> environment variables, for example in the file <tt>/etc/environment</tt> or <tt>~/.bashrc</tt>.</p> <p><strong>Aargh! The script fails with an error - have I downloaded all those MBs in vain?!</strong></p> <p>Of course this Should Not Happen(tm), but for various reasons you may end up in a state where a large "<tt>.iso.tmp</tt>" file has already been generated and <tt>jigdo-lite</tt> appears to have problems, telling you repeatedly to try restarting the download. There are several possible things to try in this case:</p> <ul> <li>Simply restart the download by pressing Return. Maybe some of the files could not be downloaded because of timeouts or other transient errors - another attempt will be made to download any missing files.</li> <li>Try a different mirror. Some Debian mirrors are slightly out of sync - maybe a different mirror still holds files that were deleted from the one you specified, or it has already been updated with files that are not yet present on your mirror.</li> <li>Retrieve the missing parts of the image using <tt><a href="https://rsync.samba.org/">rsync</a></tt>. First, you need to find out the correct rsync URL of the image you are downloading: Choose a server that offers rsync access to the <a href="../mirroring/rsync-mirrors">stable</a> or <a href="../http-ftp/#testing">testing</a> images, then determine the correct path and filename. Directory listings can be obtained with commands like <tt>rsync rsync://cdimage.debian.org/debian-cd/</tt> <br>Next, remove the "<tt>.tmp</tt>" extension from <tt>jigdo-lite</tt>'s temporary file by renaming it, and pass both the remote URL and the local filename to rsync: <tt>rsync rsync://server.org/path/binary-i386-1.iso binary-i386-1.iso</tt> <br>You may want to use rsync's <tt>--verbose</tt> and <tt>--progress</tt> switches to get status messages, and <tt>--block-size=8192</tt> to increase its speed.</li> <li>If all else fails, your downloaded data is still not lost: Under Linux, you can loop-mount the <tt>.tmp</tt> file to access the packages that were already downloaded, and reuse them for generating an image from a newer jigdo file (such as the latest weekly testing snapshot if your failed download was also a testing snapshot). To do this, first issue the following commands as root in the directory with the broken download: <tt>mkdir mnt; mount -t iso9660 -o loop *.tmp mnt</tt>. Next, start a new download in a different directory, and enter the path of the <tt>mnt</tt> directory at the "Files to scan" prompt.</li> </ul> </div>  <div class="clr"></div> </div>  <div id="footer"> <hr class="hidecss"> <ul class="subnav"> <li><a href="../../CD/">debian_on_cd</a></li> <li><a href="../../CD/faq/">faq</a></li> <li><a href="../../CD/netinst/">net_install</a></li> <li><a href="../../CD/vendors/">buy</a></li> <li><a href="../../CD/jigdo-cd/">jigdo</a></li> <li><a href="../../CD/http-ftp/">http_ftp</a></li> </ul> <hr>  <div id="pageLang"> <div id="langSelector"> This page is also available in the following languages: <div id="langContainer"> <select onchange="location = this.value;"> <option value="" disabled selected>Select your language</option> <option value="index.da.html" title="Danish" lang="da">dansk</option> <option value="index.de.html" title="German" lang="de">Deutsch</option> <option value="index.es.html" title="Spanish" lang="es">español</option> <option value="index.fr.html" title="French" lang="fr">français</option> <option value="index.it.html" title="Italian" lang="it">Italiano</option> <option value="index.nl.html" title="Dutch" lang="nl">Nederlands</option> <option value="index.pl.html" title="Polish" lang="pl">polski</option> <option value="index.pt.html" title="Portuguese" lang="pt">Português</option> <option value="index.sk.html" title="Slovak" lang="sk">sloven膷ina</option> <option value="index.fi.html" title="Finnish" lang="fi">suomi</option> <option value="index.sv.html" title="Swedish" lang="sv">svenska</option> <option value="index.bg.html" title="Bulgarian" lang="bg">Български (Bəlgarski)</option> <option value="index.ru.html" title="Russian" lang="ru">Русский (Russkij)</option> <option value="index.uk.html" title="Ukrainian" lang="uk">українська (ukrajins'ka)</option> <option value="index.zh-cn.html" title="Chinese (China)" lang="zh-CN">中文(简)</option> <option value="index.zh-hk.html" title="Chinese (Hong Kong)" lang="zh-HK">中文(HK)</option> <option value="index.zh-tw.html" title="Chinese (Taiwan)" lang="zh-TW">中文(繁)</option> <option value="index.ja.html" title="Japanese" lang="ja">日本語 (Nihongo)</option> <option value="index.cs.html" title="Czech" lang="cs">česky</option> <option value="index.ko.html" title="Korean" lang="ko">한국어 (Korean)</option> </select> </div> How to set <a href="../../intro/cn">the default document language</a> </div></div> <hr>  <p><small>English-language <a href="/MailingLists/disclaimer">public mailing list</a> for CDs/DVDs:<br>Debian CD team <<a href="mailto:debian-cd@lists.debian.org">debian-cd@lists.debian.org</a>></small></p> <div id="footermap">  <p><strong><a href="/">Home</a></strong></p> <ul id="footermap-cola"> <li><a href="../../intro/about">About</a> <ul> <li><a href="../../social_contract">Social Contract</a></li> <li><a href="../../code_of_conduct">Code of Conduct</a></li> <li><a href="../../intro/free">Free Software</a></li> <li><a href="../../legal">Legal Info</a></li> </ul> </li> <li><a href="../../intro/help">Help Debian</a></li> </ul> <ul id="footermap-colb"> <li><a href="../../distrib/">Getting Debian</a> <ul> <li><a href="../../distrib/netinst">Network install</a></li> <li><a href="../../CD/">CD/USB ISO images</a></li> <li><a href="../../blends/">Pure Blends</a></li> <li><a href="../../distrib/packages">Debian Packages</a></li> <li><a href="../../devel/">Developers' Corner</a></li> </ul> </li> </ul> <ul id="footermap-colc"> <li><a href="../../News/">News</a> <ul> <li><a href="../../News/weekly/">Project News</a></li> <li><a href="../../events/">Events</a></li> </ul> </li> <li><a href="../../doc/">Documentation</a> <ul> <li><a href="../../releases/">Release Info</a></li> <li><a href="https://wiki.debian.org/">Debian Wiki</a></li> </ul> </li> </ul> <ul id="footermap-cold"> <li><a href="../../support">Support</a> <ul> <li><a href="../../international/">Debian International</a></li> <li><a href="../../security/">Security Information</a></li> <li><a href="../../Bugs/">Bug reports</a></li> <li><a href="../../MailingLists/">Mailing Lists</a></li> </ul> </li> </ul> <ul id="footermap-cole"> <li><a href="../../sitemap">Site map</a></li> <li><a href="https://search.debian.org/">Search</a></li> <li><a href="https://bits.debian.org">The Debian Blog</a></li> <li><a href="https://micronews.debian.org">Debian Micronews</a></li> <li><a href="https://planet.debian.org">Debian Planet</a></li> </ul>  </div>  <div id="fineprint">  <p> Last Modified: Sat, Sep 14 15:24:13 UTC 2024 &emsp; Last Built: Sat, Nov 9 23:26:37 UTC 2024 <br> Copyright © 1997-2024 <a href="https://www.spi-inc.org/">SPI</a> and others; See <a href="../../license" rel="copyright">license terms</a><br> Debian is a registered <a href="../../trademark">trademark</a> of Software in the Public Interest, Inc. </p>  </div>  </div>  </body> </html>