| 1 |
#if 0 |
| 2 |
Input file for docs in multiple different directories. Process with |
| 3 |
cpp. |
| 4 |
#endif |
| 5 |
|
| 6 |
<h1>What's in this directory?</h1> |
| 7 |
|
| 8 |
#ifdef STYLElist |
| 9 |
|
| 10 |
<p>These are list files.</p> |
| 11 |
|
| 12 |
<h2>How do I use these files?</h2> |
| 13 |
|
| 14 |
<p> |
| 15 |
The list files here simply describe what files are contained in |
| 16 |
each Debian ISO image, in order to help users find which images |
| 17 |
they might want to download. They are simply text files, compressed |
| 18 |
to save space and download time.</p> |
| 19 |
|
| 20 |
#else |
| 21 |
# ifdef ARCHsource |
| 22 |
|
| 23 |
<p>These are files containing source code for the Debian |
| 24 |
operating system.</p> |
| 25 |
|
| 26 |
# else |
| 27 |
|
| 28 |
<p>These are files containing the installer and other software |
| 29 |
for the Debian GNU/KERNEL operating system. |
| 30 |
|
| 31 |
# ifdef ARCHmulti |
| 32 |
|
| 33 |
The files in this directory are designed to work on both 32-bit |
| 34 |
and 64-bit PCs (<code>i386</code> and <code>amd64</code>). |
| 35 |
|
| 36 |
# else |
| 37 |
|
| 38 |
The files in this directory are specifically for |
| 39 |
the <code>ARCH</code> architecture. |
| 40 |
|
| 41 |
# endif |
| 42 |
|
| 43 |
</p> |
| 44 |
|
| 45 |
# endif |
| 46 |
|
| 47 |
<h2>How do I use these files?</h2> |
| 48 |
|
| 49 |
# ifdef STYLEjigdo |
| 50 |
|
| 51 |
<p>The files here are in "jigdo" |
| 52 |
format. Use <a href="https://www.debian.org/CD/jigdo-cd/">jigdo</a> |
| 53 |
tools to download the contents of the complete ISO image files |
| 54 |
from what's here and a normal Debian mirror. You should end up |
| 55 |
with an exact copy of each ISO image as though you'd downloaded |
| 56 |
it directly via HTTP or FTP.</p> |
| 57 |
|
| 58 |
# elif defined(STYLEbt) |
| 59 |
|
| 60 |
<p>The files here are bittorrent files. Use |
| 61 |
a <a href="https://www.debian.org/CD/torrent-cd/">bittorrent</a> |
| 62 |
client program to download the contents of the complete ISO image |
| 63 |
files in a peer-to-peer manner. You should end up with an exact |
| 64 |
copy of each ISO image as though you'd downloaded it directly via |
| 65 |
HTTP or FTP.</p> |
| 66 |
|
| 67 |
# elif defined(STYLEiso) |
| 68 |
|
| 69 |
<p>The files here are complete ISO images, ready to use.</p> |
| 70 |
|
| 71 |
# endif |
| 72 |
|
| 73 |
<p> Once you have downloaded all the ISO images you want, you will |
| 74 |
typically need to write them to installation media.</p> |
| 75 |
|
| 76 |
<h2>What size and type of media will I need?</h2> |
| 77 |
|
| 78 |
<p>The images described here are sized to be written to |
| 79 |
|
| 80 |
# ifdef TYPEcd |
| 81 |
writeable CD media |
| 82 |
# elif TYPEdvd |
| 83 |
writeable DVD media |
| 84 |
# elif TYPEbd |
| 85 |
writeable Blu-Ray media |
| 86 |
# elif TYPE16G |
| 87 |
16GB USB media |
| 88 |
# elif TYPEdlbd |
| 89 |
writeable dual-layer Blu-Ray media |
| 90 |
# endif |
| 91 |
|
| 92 |
at a minimum, but may be written to larger media if needed.</p> |
| 93 |
|
| 94 |
# ifdef ISOHYBRID |
| 95 |
|
| 96 |
<p>For extra convenience, <strong>these images may also be written |
| 97 |
directly to a USB stick</strong>. So long as your computer will |
| 98 |
boot directly from that USB stick, it should start the Debian |
| 99 |
installer that way. |
| 100 |
|
| 101 |
# if defined(TYPEdvd) |
| 102 |
|
| 103 |
The first DVD in this set is also deliberately limited in size |
| 104 |
so it should fit on a standard-sized 4GB USB stick. |
| 105 |
|
| 106 |
# endif |
| 107 |
# endif |
| 108 |
</p> |
| 109 |
|
| 110 |
# if !defined(ONEonly) && !defined(ARCHsource) |
| 111 |
|
| 112 |
<h2>There are lots of files here! Do I need all of them?</h2> |
| 113 |
|
| 114 |
<p>In most cases it is not necessary to download and |
| 115 |
use <strong>all</strong> of these images to be able to install |
| 116 |
Debian on your computer. Debian comes with a massive set of |
| 117 |
software packages, hence why it takes so many disks for a |
| 118 |
complete set. Most typical users only need a small subset of |
| 119 |
those software packages.</p> |
| 120 |
|
| 121 |
# if !defined(TYPEcd) |
| 122 |
|
| 123 |
<p>Initially, you will only need to download and use |
| 124 |
the <strong>first</strong> image of a set (labelled as |
| 125 |
<code>debian-<i>something</i>-1</code> to be able to start the |
| 126 |
Debian installer and set up Debian on your computer. If there are |
| 127 |
more images available here |
| 128 |
(labelled <code>debian-<i>something</i>-2</code>, |
| 129 |
<code>debian-<i>something</i>-3</code>, etc.), they contain the |
| 130 |
extra packages that can be installed on a Debian system (as |
| 131 |
mentioned previously). They will <strong>not</strong> be |
| 132 |
bootable and are entirely optional. If you have a fast Internet |
| 133 |
connection, you're most likely better off installing any |
| 134 |
desired extra packages directly from the Debian mirrors on the |
| 135 |
Internet instead of by using these extra images.</p> |
| 136 |
|
| 137 |
# endif |
| 138 |
|
| 139 |
# endif |
| 140 |
|
| 141 |
# if defined(TYPEcd) && !defined(ARCHsource) && !defined(STYLElist) |
| 142 |
|
| 143 |
<h2>What is a netinst image?</h2> |
| 144 |
|
| 145 |
<p>The <code>netinst</code> CD here is a small CD image that |
| 146 |
contains just the core Debian installer code and a small core set |
| 147 |
of text-mode programs (known as "standard" in Debian). To install |
| 148 |
a desktop or other common software, you'll also need either an |
| 149 |
Internet connection or some other Debian CD/DVD images.</p> |
| 150 |
|
| 151 |
# if defined(ARCHi386) |
| 152 |
|
| 153 |
<h2>What is an edu netinst image?</h2> |
| 154 |
|
| 155 |
<p>The <code>edu netinst</code> CD here is a special version of |
| 156 |
the netinst CD image that is targeted specifically at 32-bit |
| 157 |
Intel machines. It provides a menu to install the Debian Edu Pure |
| 158 |
Blend. See the <a href="https://wiki.debian.org/DebianEdu/"> |
| 159 |
Debian Wiki</a> for more information.</p> |
| 160 |
|
| 161 |
# endif |
| 162 |
|
| 163 |
# if defined(ARCHamd64) |
| 164 |
|
| 165 |
<h2>What is an edu netinst image?</h2> |
| 166 |
|
| 167 |
<p>The <code>edu netinst</code> CD here is a special version of |
| 168 |
the netinst CD image that is targeted specifically at 64-bit |
| 169 |
Intel machines. It provides a menu to install the Debian Edu Pure |
| 170 |
Blend. See the <a href="https://wiki.debian.org/DebianEdu/"> |
| 171 |
Debian Wiki</a> for more information.</p> |
| 172 |
|
| 173 |
# endif |
| 174 |
|
| 175 |
# if defined(ARCHi386) |
| 176 |
|
| 177 |
<h2>What is a mac netinst image?</h2> |
| 178 |
|
| 179 |
<p>The <code>mac netinst</code> CD here is a special version of |
| 180 |
the netinst CD image that is targeted specifically at older |
| 181 |
32-bit Intel Macintosh machines. It will likely work on most |
| 182 |
other i386 machines too, but it does not contain UEFI boot |
| 183 |
files that some people |
| 184 |
need. See <a href="https://wiki.debian.org/MacMiniIntel#Macmini_1.2C1"> |
| 185 |
the Debian Wiki</a> for more information.</p> |
| 186 |
|
| 187 |
# endif |
| 188 |
|
| 189 |
# if defined(ARCHamd64) |
| 190 |
|
| 191 |
<h2>What is a mac netinst image?</h2> |
| 192 |
|
| 193 |
<p>The <code>mac netinst</code> CD here is a special version of |
| 194 |
the netinst CD image that is targeted specifically at older |
| 195 |
64-bit Intel Macintosh machines. It will likely work on most |
| 196 |
other amd64 machines too, but it does not contain UEFI boot |
| 197 |
files that some people |
| 198 |
need. See <a href="https://wiki.debian.org/MacMiniIntel#Macmini_2.2C1"> |
| 199 |
the Debian Wiki</a> for more information.</p> |
| 200 |
|
| 201 |
# endif |
| 202 |
|
| 203 |
# endif |
| 204 |
|
| 205 |
# if defined(TYPEbd) && !defined(ARCHsource) && !defined(STYLElist) |
| 206 |
|
| 207 |
# if defined(ARCHi386) |
| 208 |
|
| 209 |
<h2>What is an edu BD image?</h2> |
| 210 |
|
| 211 |
<p>The <code>edu</code> BD here is a special version of |
| 212 |
the BD image that is targeted specifically at 32-bit Intel machines. |
| 213 |
It provides a menu to install the Debian Edu Pure Blend without the |
| 214 |
need of an Internet connection. See the |
| 215 |
<a href="https://wiki.debian.org/DebianEdu/">Debian Wiki</a> for |
| 216 |
more information.</p> |
| 217 |
|
| 218 |
# endif |
| 219 |
|
| 220 |
# if defined(ARCHamd64) |
| 221 |
|
| 222 |
<h2>What is an edu BD image?</h2> |
| 223 |
|
| 224 |
<p>The <code>edu</code> BD here is a special version of |
| 225 |
the BD image that is targeted specifically at 64-bit Intel machines. |
| 226 |
It provides a menu to install the Debian Edu Pure Blend without the |
| 227 |
need of an Internet connection. See the |
| 228 |
<a href="https://wiki.debian.org/DebianEdu/">Debian Wiki</a> for |
| 229 |
more information.</p> |
| 230 |
|
| 231 |
# endif |
| 232 |
|
| 233 |
# endif |
| 234 |
|
| 235 |
# ifdef UPDATES |
| 236 |
|
| 237 |
<p>The <code>update</code> files here are extra convenience files |
| 238 |
for people updating from previous versions of Debian. If you are |
| 239 |
installing fresh, you may safely ignore |
| 240 |
them. <a href="https://www.debian.org/CD/faq/#update-cd">More |
| 241 |
details...</a></p> |
| 242 |
|
| 243 |
# endif |
| 244 |
|
| 245 |
<h2>How can I verify my download is correct and exactly what has |
| 246 |
been created by Debian?</h2> |
| 247 |
|
| 248 |
<p>There are files here (SHA512SUMS, etc.) which contain checksums |
| 249 |
of the images. These checksum files are also signed - see the |
| 250 |
matching .sign files. Once you've downloaded an image, you can |
| 251 |
check:</p> |
| 252 |
|
| 253 |
<ul> |
| 254 |
<li>that its checksum matches that expected from the checksum file; and |
| 255 |
<li>that the checksum file has not been tampered with. |
| 256 |
</ul> |
| 257 |
|
| 258 |
<p>For more information about how to do these steps, read |
| 259 |
the <a href="https://www.debian.org/CD/verify">verification guide</a>. |
| 260 |
|
| 261 |
#endif |
| 262 |
|
| 263 |
#if !defined(ONEonly) && (defined(STYLEbt) || defined(STYLEiso)) |
| 264 |
|
| 265 |
<h2>Only the first few images are available! Where are the rest?</h2> |
| 266 |
|
| 267 |
<p>We don't store/serve the full set of ISO images for all |
| 268 |
architectures, to reduce the amount of space taken up on the |
| 269 |
mirrors. You can |
| 270 |
<a href="https://www.debian.org/CD/faq/#why-jigdo">use the jigdo |
| 271 |
tool</a> to recreate the missing ISO images instead.</p> |
| 272 |
|
| 273 |
#endif |
| 274 |
|
| 275 |
<h2>Non-free Firmware</h2> |
| 276 |
|
| 277 |
<p>This Debian image build only includes Free Software where |
| 278 |
possible. However, many systems include hardware which depends on |
| 279 |
non-free firmware to function properly so this build also includes |
| 280 |
those firmware files for those cases. See the Debian |
| 281 |
Wiki <a href="https://wiki.debian.org/Firmware">non-free |
| 282 |
firmware</a> page for more information. |
| 283 |
|
| 284 |
<h2>Other questions?</h2> |
| 285 |
|
| 286 |
<p>See the Debian CD <a href="https://www.debian.org/CD/faq/">FAQ</a> |
| 287 |
for lots more information about Debian CDs and installation.</p> |
| 288 |
|
| 289 |
<p>The images here were put together by |
| 290 |
the <a href="https://wiki.debian.org/Teams/DebianCd">Debian CD team</a> |
| 291 |
, using debian-cd and other software.</p> |