fix typo
[ikiwiki.git] / download.mdwn
1 # Obtaining DragonFly for your system
2
3 [[!toc  levels=3]]
4
5 ## Images
6
7 DragonFly images are 'live', meaning these images on whatever media will boot your system and let you log in as `root` (no password).  You can use this feature to check for hardware compatibility and play with DragonFly a little before actually installing it on your hard drive.  The CD includes an installer that can be run at the console. To activate the installer, boot and login as `installer`. 
8
9 If you use the DVD, you can login as `root` and start a GUI with *startx*.  If you use a USB .img file, it needs to be copied to a USB key directly.  Use *dd* on unix-like systems, or [a similar program](http://www.chrysocome.net/dd) on Windows.
10
11 * **Current RELEASE — [[2.6.3|/release26/]]**:
12  * i386:
13  [CD](http://mirror-master.dragonflybsd.org/iso-images/dfly-i386-2.6.3_REL.iso.bz2)
14 [USB](http://mirror-master.dragonflybsd.org/iso-images/dfly-i386-2.6.3_REL.img.bz2)
15  * x86_64:
16 [CD](http://mirror-master.dragonflybsd.org/iso-images/dfly-x86_64-2.6.3_REL.iso.bz2)
17 [USB](http://mirror-master.dragonflybsd.org/iso-images/dfly-x86_64-2.6.3_REL.img.bz2)
18 * Daily **SNAPSHOT**: [here](http://mirror-master.dragonflybsd.org/snapshots/)
19
20 Here is a list of [[**worldwide mirrors**|/mirrors]] offering DragonFly ISO images.  *Please use an appropriate mirror for best results!*
21
22 ### Legacy Releases
23
24 To limit disk space requirements all mirrors carry only the ISO images/packages of the current and the last release. ISO images/packages of older releases are available [here](ftp://ftp.dragonflybsd.org/Older/).
25
26 ## Binary pkgsrc packages
27
28 We offer a reasonable number of binary pkgsrc packages for every stable release of DragonFly.  Look at the [[list|mirrors]] of worldwide mirrors to find a mirror near you carrying binary packages.  See the [[pkgsrc page|docs/howtos/HowToPkgsrc/]] how to install these packages.
29
30 Pkgsrc sources can now be obtained via git instead of CVS, and we recommend that our git mirror be used instead of loading down NetBSD's CVS servers. The pkgsrc git uri which mirrors the NetBSD pkgsrc cvs repo is: `git://git.dragonflybsd.org/pkgsrcv2.git`
31
32 To obtain the pkgsrc tree via git:
33
34     # cd /usr
35     # make pkgsrc-create
36
37 Beware of <a href="http://leaf.dragonflybsd.org/mailarchive/users/2010-09/msg00197.html">pkgsrc git repository change</a>, with release 2.6.3 you will need to update the address in the Makefile:
38
39     # cd /usr
40     # chmod u+w Makefile
41     # perl -i -ne 's/pkgsrc\.git/pkgsrcv2.git/;print' Makefile
42     # chmod u-w Makefile
43     # make pkgsrc-create
44
45
46 ## Obtaining source via git
47
48 Since DragonFly 2.1 the source repository is maintained with git instead of CVS. To clone the sources using git:
49
50     # cd /usr
51     # make src-create
52
53 This will fetch all sources for you from a fast mirror. If the <i>git-clone</i> command is not available update your Makefile to a recent version. If you do not have git installed, install it from `pkgsrc/devel/scmgit`. See [development(7)](http://leaf.dragonflybsd.org/cgi/web-man?command=development&section=ANY") for further instructions how to work with the repository.
54
55 All release CDs and images also contain a base git repo for pkgsrc and a populated /usr/pkg containing the git tools and may be used to bootstrap pkgsrc support in your system if you desire.
56
57 ## DragonFly Releases
58
59 Releases occur approximately twice a year.  DragonFly release branches **only contain bug and security fixes** and are designed for people running production systems who don't want any surprises.  Brand-new features often discussed on the mailing lists are typically not in release branches.
60
61 DragonFly systems based on releases are labeled RELEASE, for example, you might be running **DragonFly X.Y.Z-RELEASE**.  If you run a daily snapshot or track *git master*, you'll see **X.Y.Z-DEVELOPMENT** as your system version.
62
63 ## Commercial Sites
64
65 A number of commercial sites selling DragonFly related material is [[here|commercial]].