Debian on CD

Frequently Asked Questions

What is a CD image anyway?

A CD image is the exact representation of the data on a CD in a normal computer file, that can e.g. be transmitted over the Internet. CD burning programs can use the image files to make real CDs.

For a correctly written CD, the .iso file must not appear on the CD when you access it! Instead, you should see a number of files and directories - in the case of a Debian CD, this includes a dists directory and a README.html file.

The .iso format is roughly comparable to a .zip file: It contains other files and directories, and only these will appear on the final CD. Some archive programs allow you to unpack .iso files. Do not use this feature to create a CD from the unpacked files! The resulting CD will fail to boot because the .iso format includes special information related to booting from the CD, which is lost when you unpack the file. See below on how to correctly write a CD image under Linux, Windows or Mac OS.

My question is not answered by this FAQ!

If you cannot find an answer to your question here, you can ask for help on one of the Debian mailing lists. In all cases, you should search the mailing list archives before sending mail to the lists. You can subscribe to and unsubscribe from the lists. However, you do not need to be subscribed in order to send mail to the lists - if you are not subscribed, ask for replies to be CC'd to you.

Mailing lists relevant to problems with CD installation:

Why should I use this jigdo program? I prefer a simple HTTP or FTP download!

Today, there are nearly 300 Debian mirrors (which contain the complete Debian distribution as .deb files), but far fewer machines serving Debian CD images. As a result, the CD image servers are constantly overloaded.

Additionally, nobody is very enthusiastic about setting up more CD servers because of the tremendous amounts of wasted bandwidth (some people keep restarting failed downloads instead of resuming from the point where the connection was closed) and because a regular mirror is more attractive (it allows continuous upgrades of Debian, or using the testing/unstable distribution instead of the stable one).

jigdo tries to make the most out of this situation, by downloading the data for the CD images from one of the 300 mirrors. However, these mirrors only hold individual .deb files, not the CD image, so some additional manipulation of the data is necessary to produce one big CD image file from the many small .deb files.

Do not be afraid to try out jigdo! The complex process of generating the CD image is completely hidden from you - instead, you benefit from the fact that one of the 300 Debian mirrors is bound to be nearer and faster than any of the CD servers.

Which of the numerous images should I download? Do I need all of them?

No. First, of course you only need to download either CD or DVD images - the two types of images contain the same packages.

Also, you only need the CD/DVD images for your computer's architecture. The architecture is the type of hardware your computer uses. By far the most popular one is the Intel/AMD architecture, so most people will only want to get the images for i386. If your PC has a 64-bit AMD or Intel processor, you will most likely need the amd64 images (though i386 is also fine), the ia64 images will not work.

Furthermore, in most cases it is not necessary to download all of the images for your architecture. The packages are sorted by popularity: The first CD/DVD contains the installation system and the most popular packages. The second one contains slightly less popular ones, the third one even less popular ones, etc. You will probably only need the first DVD (or the first two CDs) unless you have very special requirements. (And in case you happen to need a package later on which is not on one of the CDs/DVDs you downloaded, you can always install that package directly from the Internet.)

Please also read the next paragraphs to determine whether you want/need to download network install CDs, update CDs or source CDs.

What is a netinst or network install CD?

To quote the network install page: A network install or netinst CD is a single CD which enables you to install the entire operating system. This single CD contains just the minimal amount of software to start the installation and fetch the remaining packages over the Internet.

If you only want to install Debian on a single machine which has a fast Internet connection, the network install may be the fastest and easiest option for you: You only download the packages that you selected for installation on your machine, which saves both time and bandwidth.

What are the update CDs/DVDs?

Update CDs/DVDs are CDs/DVDs which contain all the packages that changed between the zero micro version number (e.g. 5.0.0, 6.0.0, etc.) and a later point release of the current stable distribution. For example, if you already have the full set of debian-6.0.0 CDs/DVDs, you can use the debian-update-6.0.1 CD to turn this debian-6.0.0 set into a debian-6.0.1 set.

This type of CD/DVD is intended for vendors having large amounts of pressed zero micro version number CDs/DVDs (which makes them cheaper than individually burned CDs/DVDs). If you order CDs/DVDs from such a vendor, it is possible that you receive CDs/DVDs for a slightly older point release, plus an update CD/DVD for the latest revision. This is a perfectly acceptable way of distributing Debian on CD/DVD.

Of course, this type of CD/DVD can also be useful to you as an end user; instead of creating the full set of CDs/DVDs for each new revision of a release, you only need to download and burn update CDs/DVDs for your architecture.

Note that update CDs/DVDs are not meant to boot, they just contain the packages needed to upgrade an existing installation. If you don't have that existing installation, then you'll need to use the normal installation CDs/DVDs. After the new system is booted, the updated CD/DVD can be added with apt-cdrom add.

Now, what if for some reason you do not want to download the update CD/DVD even though you already have the full set of CDs/DVDs for the previous revision? In this case, you should consider using jigdo's update feature: jigdo can read the contents of the old CDs/DVDs, download only those files that have changed for the new CDs/DVDs, and create the full set of new CDs/DVDs. Still, it will have done this by downloading only about the same amount of data as for an update CD/DVD.

What are the source CDs?

There are two types of images, the binary CDs that contain precompiled, ready-to-run programs, and the source CDs that contain the source code for the programs. The vast majority of people do not need the source CDs; you should not download them unless you really have a good reason for it.

Where is the CD image with non-free?

Debian has a quite strict view with regard to the licenses of software: Only software that is Free in the sense of the Debian Free Software Guidelines is allowed into the actual distribution. All the other, non-free software (for example, software for which source code is not available) is not supported officially.

The official CDs may freely be used, copied and sold by anyone anywhere in the world. Packages of the non-free category have restrictions that conflict with this, so these packages are not placed on the official CDs.

Sometimes, someone is kind enough to create unofficial non-free CDs. If you cannot find any links on this website, you can try asking on the debian-cd mailing list.

Are DVD images of Debian available?

Yes - Debian offers DVD images for the current stable release. Additionally, as far as we know, Debian is the only Linux distribution to offer weekly full-size DVD images for download! Because of their size, these images are distributed with jigdo.

What's the difference between official and unofficial images?

Official images are built by a member of the Debian CD team and have undergone some testing to ensure they work. Once they have been released, the images never change - if they turn out to be broken, a new set with a different version number is released.

Unofficial images can be built by anyone - CD team members, other Debian developers or even advanced Debian users. Typically, they are more up-to-date, but have received less testing. Some have new features (e.g. installation support for new hardware), or contain additional software packages which are not part of the Debian archive.

Is a Debian live CD available?

Yes. A so-called live CD, or more precisely, a live system, is a complete system prepared for a CD, DVD, USB key or other medium. You do not need to install anything on the hard drive. Instead you boot from the CD or other medium and are able to start working on the machine right away. All programs run directly from the medium.

The Debian Live Project produces live image files for a variety of system types and media.

The CD/DVD fails to boot! / From which CD should I boot?

Only the first CD/DVD in a set is bootable.

If your Debian CD fails to boot, first ensure that you have correctly written it to the CD-R(W) medium - please see the explanation above. Additionally, please check whether your BIOS is set up to boot from the CD/DVD drive.

If your system cannot boot from CD at all, it is also possible to boot from a USB stick or from the network.

Where are the images for M68K, Hurd or other architectures?

Depending on the state of support for a certain architecture, CD/DVD images are available from different places:

Are images for the unstable distribution available?

There are no unstable full CD or DVD images. Due to the fact that the packages in unstable change so quickly, it is more appropriate for people to download and install unstable using a normal Debian FTP mirror.

If you are aware of the risks of running unstable, but still want to install it, you have two choices:

Which CD/DVD image contains package XYZ?

To find out which image contains a certain file, use the cdimage search tool. It has knowledge of just about all the Debian CDs and DVDs produced by Debian since the Woody release, covering all the official releases (both older archived releases and the current stable release) and the current sets of daily and weekly testing builds.

Can I have a list of all the packages contained in an image?

Yes. Look on cdimage.debian.org for the corresponding .list.gz file - it will list all the packages and source files included in the image. For Debian Live images, you can find in the same directory as the image files some similarly named files suffixed with .packages. Download these and then search them for the desired package name.

The software on the official CDs is outdated - why don't you release a new version?

We only make official releases of the stable distribution when we think they truly deserve that name. Unfortunately, this means that stable releases only happen about every 1.5 to 2 years...

If you require more recent versions of some of the software in Debian, you can install stable and then upgrade (via the net) those parts you want to the versions from testing - it is possible to mix software from the different releases.

Alternatively, try out the CD images of testing that are generated automatically every week. In this case, be sure to set up your computer correctly to receive testing security updates, especially if you run testing on a server. More information about testing security support is available from the security FAQ.

If you only need newer versions of specific packages, you can also try the backports service, which takes packages from testing and modifies them to work on stable. This option may be safer than installing the same package directly from testing.

How do I know if I am downloading the newest CD images?

The note at the bottom of the Debian on CD page always shows the version number of the latest release.

How can I verify the downloaded ISO images and written optical media?

Detailed information on how to authenticate the signed checksum files containing the checksums of the ISO image files is available on the authenticity verification page. After cryptographically verifying the checksum files, we can check that:

The problem with the verification of written optical media is that some media types will possibly return more bytes than those found in the ISO image. This trailing garbage is impossible to avoid with CD written in TAO mode, incrementally recorded DVD-R[W], formatted DVD-RW, DVD+RW, BD-RE, and also with USB keys. Therefore, we need to read exactly the same number of sectors of data from the media as are found in the ISO image itself; reading any more bytes from the media will alter the checksum result.

Alternatively, there is a useful helper script called check_debian_iso which can verify ISO image files and optical media, reading the appropriate amount of bytes from media then computing the checksum and comparing it against the checksum file.

Why is my downloaded DVD image smaller than 1 GB when it should be larger than 4 GB?

Most likely, the tool you use for downloading the image does not have large file support, i.e. it has problems downloading files larger than 4 GBytes. The usual symptom for this problem is that when you download the file, the file size reported by your tool (and the amount of data that it downloads) is too small by exactly 4 GB. For example, if the DVD image is 4.4 GB large, your tool will report a size of 0.4 GB.

Some versions of wget also suffer from this problem - either upgrade to a version of wget which does not have this restriction or use the curl command line download tool: curl -C - [URL]

How do I write an ISO image under Linux/Unix?

Note that Debian ISO images for i386 and amd64 are also bootable from a USB key; see below.

xorriso for all optical media types (also doable as non-root user):
xorriso -as cdrecord -v dev=/dev/sr0 -eject debian-x.y.z-arch-MEDIUM-NN.iso
In order to get the full nominal speed when writing to BD-RE (i.e. without the slowdown caused by the drive's internal defect management), add the option stream_recording=on.

growisofs for DVD and BD optical media types:
growisofs -dvd-compat -Z /dev/sr0=debian-x.y.z-arch-MEDIUM-NN.iso

wodim for CD optical media type:
wodim -v dev=/dev/sr0 -eject -sao debian-x.y.z-arch-CD-NN.iso

For Linux, there are also the X programs Brasero, K3B and X-CD-Roast, to name a few. Note that they're all frontends to the previously mentioned low-level burning applications.

Brasero
Select the button Burn Image. Then click on Click here to select a disc image, browse and select your downloaded ISO file, check whether the settings under Properties are correct and choose Create Image.
K3b
Select the menu entry Tools - CD - Burn CD Image. In the dialog that opens, enter the path to the image in the Image to Burn field, check whether the other settings are correct, then click on Start.
X-CD-Roast
After the program has started, click on Setup and choose the HD settings tab. Copy the Debian CD image to one of the directories that are displayed in the table. (If the table is empty, enter the path of a directory you want to use for temporary storage, and click on Add.) Click on OK to exit the setup. Next, select Create CD and then Write Tracks. Choose the Layout tracks tab, select the line displaying the image filename and click on Add, then click on Accept track layout. Finally, click on Write tracks.

How do I write an ISO image under Windows?

This might be a little problem, as many Windows programs use their own formats for CD images. To burn the .iso images you will most likely have to use a special menu. Look for options like ISO9660 file, Raw ISO image or 2048 bytes/sector. (Note: other bytes/sector values are fatal!) Some programs do not offer these choices; use another burning program instead (ask a friend or colleague). Here is some information about how to write CD images with specific products:

ImgBurn (Freeware)
There are screenshots of how to write an image to CD/DVD
CDBurnerXP Pro (Freeware)
The process of writing an .iso image is described in the program's manual.
ISO Recorder (Freeware)
This program can write .iso images on Windows 2003, XP and Vista.
Adaptec/Roxio Easy-CD Creator
From the File menu, choose Create CD from image.... Then select the .iso file type, and the correct image. This opens up the CD creation setup GUI, from there ensure that all the information for your CD-R is correct. In the Create options portion, choose Create CD; under Write method, choose Track at once and Close CD.
Nero from Ahead Software
Disable the Wizard, then select Burn Image from the File or Recorder menu. Select All Files in the file selection window if necessary. Select the .iso file, click OK in the this is a foreign file dialogue box, in case one is displayed. In the option box that opens, the defaults should be okay: Data Mode 1, Block Size 2048, Raw Data, Scrambled, and Swapped not selected, and Image Header and Image Trailer left at 0. Click OK. Under Write CD or Burn, use the default options, e.g. Write and Determine maximum speed, plus check the Finalize CD option.
WinOnCD Power Edition from CeQuadrat
You have to select Track Image (not CD Image!) in this program. File format is 2048 - Mode 1 or Mode 2 Form 1 Data only and Track format CD-Rom Mode 1.
CD Extreme from Sony
Choose New Job... from the File menu. Then select Global-Image or Other Image. This opens up the CD creation setup GUI, from there manually enter the path to the .iso image or browse... using files of type other. From the Edit menu, choose Recoding Options, in the resulting Disk Image Options dialog, choose:
   Recording Type: Disk at Once (DAO) Closed
   Mode and Blocking: CD Mode1 (Blocking 2048)-DVD
Do not check off Post-gap....
Microsoft Resource Kit Tools
The command-line Resource Kit Tools are provided by Microsoft free of charge, they work with Windows 2003 and XP. Two programs to write images to CD and DVD are included, they are named Cdburn.exe and Dvdburn.exe. Usage of the programs is described in the accompanying help file - essentially, the command to be executed is something like cdburn drive: iso-file.iso /speed max

If you can provide updated information or details for other programs, please let us know.

How do I write an ISO image under Mac OS?

The Toast program for Mac OS is reported to work fine with .iso files. You can be extra-safe by giving it the creator code CDr3 (or possibly CDr4) and type code iImg using e.g. FileTyper. Double-clicking on the file will then open up Toast directly, without having to drag-and-drop or go via the File-Open menu.

Another option is Disk Copy (included with Mac OS X 10.1 and higher): After opening the Disk Copy application (in the /Applications/Utilities folder), select Burn Image... in the Image menu and choose the CD image to burn. Ensure that the settings are correct, then click on Burn.

How do I write a CD image to a USB flash drive?

Several of the Debian CD and Debian Live images are created using isohybrid technology, which means that they may be used in two different ways:

The most common way to copy an image to a USB flash drive is to use the dd command on a Linux machine:

dd if=<file> of=<device> bs=4M; sync

where:

How should I label the CDs?

There is no obligatory way of labeling. However, we suggest you use the following scheme to ensure interchangeability:

Debian GNU/{Linux|Hurd|kFreeBSD} <version>[<revision>]
Official {<architecture>} {CD|DVD|BD}-<number>

For example:

Debian GNU/Linux 6.0.3
Official i386 CD-1

Debian GNU/Linux 6.0.3
Official amd64 DVD-2

Debian GNU/Linux 6.0.3
Official source BD-1

Debian GNU/kFreeBSD 6.0.3
Official i386 Netinst CD

If you have enough space, you can also add the codename to the first line, as in: Debian GNU/Linux 6.0.3 Squeeze.

Note that you are allowed to use the Official designation only on CDs the image of which has a checksum that matches the one from the jigdo files of official releases. Any CD that has no matching checksum (e.g. your own creations) must be clearly labelled as Unofficial, for example:

Debian GNU/Linux 6.0.3
Unofficial Non-free

In the case of official weekly snapshots, version numbers like 6.0.3 should not be used to avoid confusion with released Debian versions. Instead, label the image with a codename like etch or a distribution name like testing. Also add Snapshot and the date of the snapshot:

Debian GNU/Linux etch
Official Snapshot alpha Binary-2
2005-06-17

Is there any artwork for CDs and covers?

There is no official layout for the cover, back and label of a Debian CD, but a number of people have produced nice-looking images. Please see the separate artwork page.

Are old CD/DVD images still available?

Some older images are available from the archive section on cdimage.debian.org. For example, you might want to try out older images if you need support for a certain (sub)architecture which has been dropped for a newer release.

Note that when you install using a really old CD/DVD (pre 4.0, Etch), the contents of /etc/apt/sources.list will reference the current stable Debian release by default. This means that any upgrade over the net will upgrade to the current stable release.

What is the best way of installing Debian on many interconnected computers?

If you want to install Debian on a large number of machines and then keep all these installations up-to-date (e.g. security updates), installing from CD ROM is not ideal, but then neither is installing via the Internet, because the packages will have to be downloaded again for each machine. In this case, you should set up a local cache, the three options being:

Installing on a large number of machines can be tricky. Fully automatic installation (FAI), which is also available as a Debian package, may help you with this task.

I have a local Debian mirror and want to create my own CDs. How do I do this?

Apart from a local Debian mirror, you also need plenty of disc space. The CD creation scripts are packaged in the debian-cd package. However, it is usually a better idea to use the latest code from SVN. (Still, you should have a look at the package's dependencies to ensure you have all the necessary tools.)

To get the latest SVN version, make sure you have SVN installed. From an empty directory, give the following command:

svn co svn://svn.debian.org/svn/debian-cd/trunk

Should you try to use the scripts, check the debian-cd mailing list archive for solutions to the problems that will inevitably show up. :-)

How do I become a mirror for Debian CD images?

The necessary steps to set up your CD image mirror and keep it up to date are described on a separate page.

Some Images are missing! Only the first n images are available! Where is the rest?

We don't store/serve the full set of ISO images for all architectures, to reduce the amount of space taken up on the mirrors. You can use the jigdo tool to recreate the missing ISO images instead.