legacy isos are not in ftp://ftp.dragonflybsd.org/iso-images/ (use island instead)
[ikiwiki.git] / download.mdwn
1# Obtaining DragonFly for your system
0cbe7807 3[[!toc levels=3]]
f0fa9313 5## Images
b790f880 6
4960f6c0 7DragonFly 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`.
e4b7602e 8
67f7b4b9 9If 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).
b790f880 10
58ceee05 11**i386:** [CD](http://mirror-master.dragonflybsd.org/iso-images/dfly-i386-3.0.2_REL.iso.bz2) | [USB](http://mirror-master.dragonflybsd.org/iso-images/dfly-i386-3.0.2_REL.img.bz2) | [GUI ISO](http://mirror-master.dragonflybsd.org/iso-images/dfly-i386-gui-3.0.2_REL.iso.bz2) | [GUI USB](http://mirror-master.dragonflybsd.org/iso-images/dfly-i386-gui-3.0.2_REL.img.bz2)
82c9ab31 12
58ceee05 13**x86_64:** [CD](http://mirror-master.dragonflybsd.org/iso-images/dfly-x86_64-3.0.2_REL.iso.bz2) | [USB](http://mirror-master.dragonflybsd.org/iso-images/dfly-x86_64-3.0.2_REL.img.bz2)| [GUI ISO](http://mirror-master.dragonflybsd.org/iso-images/dfly-x86_64-gui-3.0.2_REL.iso.bz2) | [GUI USB](http://mirror-master.dragonflybsd.org/iso-images/dfly-x86_64-gui-3.0.2_REL.img.bz2)
82c9ab31 14
e4b7602e 15Daily **SNAPSHOT**: [here](http://mirror-master.dragonflybsd.org/snapshots/)
b790f880 16
98cff50c 17Here is a list of [[**worldwide mirrors**|/mirrors]] offering DragonFly ISO images. *Please use an appropriate mirror for best results!*
5f0407b6 18
be224c9d 19### Legacy Releases
a310e4d3 21To 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](http://island.quantumachine.net/archive/).
be224c9d 22
5f0407b6 23## Binary pkgsrc packages
5dc31e3a 25We 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.
b790f880 26
5dc31e3a 27Pkgsrc 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`
29To obtain the pkgsrc tree via git:
8380097c 30
31 # cd /usr
32 # make pkgsrc-create
fa19c25e 34Beware 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:
a4b4279b 35
36 # cd /usr
37 # chmod u+w Makefile
38 # perl -i -ne 's/pkgsrc\.git/pkgsrcv2.git/;print' Makefile
39 # chmod u-w Makefile
40 # make pkgsrc-create
ad696c06 42
1c758cf2 43## Obtaining source via git
b790f880 44
6286d3d4 45Since DragonFly 2.1 the source repository is maintained with git instead of CVS. To clone the sources using git:
47 # cd /usr
8380097c 48 # make src-create
6286d3d4 49
50This 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.
b790f880 51
a3b7bc10 52If you wish to check out the source repository manually, you can use
54 # git clone git://git.dragonflybsd.org/dragonfly.git dragonfly
8380097c 56All 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.
fd60e283 58## Browsing source via web interface
60The DragonFly source can be browsed via the [gitweb](http://gitweb.dragonflybsd.org/dragonfly.git) web interface.
62## DragonFly Releases
2f47390b 64Releases 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.
b790f880 65
2f47390b 66DragonFly 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.
b790f880 67
68## Commercial Sites
6e176d81 70A number of commercial sites selling DragonFly related material is [[here|commercial]].