minor style and content changes
[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  includes an installer that can be run at the console. Make sure you read the [README](http://gitweb.dragonflybsd.org/dragonfly.git/blob/HEAD:/nrelease/root/README") file for more information. 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 <a href="http://mirror-master.dragonflybsd.org/iso-images/dfly-i386-2.6.3_REL.iso.bz2">CD</a>
14 <a href="http://mirror-master.dragonflybsd.org/iso-images/dfly-i386-2.6.3_REL.img.bz2">USB</a>
15  * **x86_64**:
16 <a href="http://mirror-master.dragonflybsd.org/iso-images/dfly-x86_64-2.6.3_REL.iso.bz2">CD</a>
17 <a href="http://mirror-master.dragonflybsd.org/iso-images/dfly-x86_64-2.6.3_REL.img.bz2">USB</a>
18 * Daily **SNAPSHOT**: <a href="http://mirror-master.dragonflybsd.org/snapshots/">here</a>.
19
20 Here is a list of [[**worldwide mirrors**|/mirrors]] offering DragonFly ISO images.  *Please use an appropriate mirror for best results!*
21
22 ## Binary pkgsrc packages
23
24 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.
25
26 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`
27
28 To obtain the pkgsrc tree via git:
29
30     # cd /usr
31     # make pkgsrc-create
32
33 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:
34
35     # cd /usr
36     # chmod u+w Makefile
37     # perl -i -ne 's/pkgsrc\.git/pkgsrcv2.git/;print' Makefile
38     # chmod u-w Makefile
39     # make pkgsrc-create
40
41
42 ## Obtaining source via git
43
44 Since DragonFly 2.1 the source repository is maintained with git instead of CVS. To clone the sources using git:
45
46     # cd /usr
47     # make src-create
48
49 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.
50
51 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.
52
53 ## DragonFly Releases
54
55 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.
56
57 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.
58
59 ## Commercial Sites
60
61 A number of commercial sites selling DragonFly related material is [[here|commercial]].