(no commit message)
[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 root
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. You could also try [Image Writer for Windows](https://launchpad.net/win32-image-writer/+download). 
10
11 * **Current RELEASE — [[3.0.1|/release30/]]**:
12  * i386:
13  [CD](http://mirror-master.dragonflybsd.org/iso-images/dfly-i386-3.0.1_REL.iso.bz2)
14 [USB](http://mirror-master.dragonflybsd.org/iso-images/dfly-i386-3.0.1_REL.img.bz2)
15 [GUI](http://mirror-master.dragonflybsd.org/iso-images/dfly-i386-gui-3.0.1_REL.img.bz2)
16  * x86_64:
17 [CD](http://mirror-master.dragonflybsd.org/iso-images/dfly-x86_64-3.0.1_REL.iso.bz2)
18 [USB](http://mirror-master.dragonflybsd.org/iso-images/dfly-x86_64-3.0.1_REL.img.bz2)
19 [GUI](http://mirror-master.dragonflybsd.org/iso-images/dfly-x86_64-gui-3.0.1_REL.img.bz2)
20 * Daily **SNAPSHOT**: [here](http://mirror-master.dragonflybsd.org/snapshots/)
21
22 Here is a list of [[**worldwide mirrors**|/mirrors]] offering DragonFly ISO images.  *Please use an appropriate mirror for best results!*
23
24 ### Legacy Releases
25
26 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/iso-images/).
27
28 ## Binary pkgsrc packages
29
30 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.
31
32 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`
33
34 To obtain the pkgsrc tree via git:
35
36     # cd /usr
37     # make pkgsrc-create
38
39 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:
40
41     # cd /usr
42     # chmod u+w Makefile
43     # perl -i -ne 's/pkgsrc\.git/pkgsrcv2.git/;print' Makefile
44     # chmod u-w Makefile
45     # make pkgsrc-create
46
47
48 ## Obtaining source via git
49
50 Since DragonFly 2.1 the source repository is maintained with git instead of CVS. To clone the sources using git:
51
52     # cd /usr
53     # make src-create
54
55 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.
56
57 If you wish to check out the source repository manually, you can use
58
59     # git clone git://git.dragonflybsd.org/dragonfly.git dragonfly
60
61 anywhere or feel free to have a look around [gitweb](http://gitweb.dragonflybsd.org/dragonfly.git).
62
63 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.
64
65 ## DragonFly Releases
66
67 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.
68
69 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.
70
71 ## Commercial Sites
72
73 A number of commercial sites selling DragonFly related material is [[here|commercial]].