(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
9 If you use a GUI DVD, you can login as `root` and start a GUI with *startx*.  Note that there is no GUI release for 3.8.  You will need to install Xorg directly.  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](http://sourceforge.net/projects/win32diskimager/files/). 
10
11 Be sure to check the [[release notes|release40]].
12
13 **64-bit only:** ISO [dfly-x86_64-4.2.3_REL.iso](http://mirror-master.dragonflybsd.org/iso-images/dfly-x86_64-4.2.3_REL.iso.bz2) | USB [dfly-x86_64-4.2.3_REL.img](http://mirror-master.dragonflybsd.org/iso-images/dfly-x86_64-4.2.3_REL.img.bz2)
14
15 Daily **SNAPSHOT**: [here](http://mirror-master.dragonflybsd.org/snapshots/)  
16
17 Here is a list of [[**worldwide mirrors**|/mirrors]] offering DragonFly ISO images.  *Please use an appropriate mirror for best results!*
18
19 ### Legacy Releases
20
21 To limit disk space requirements all mirrors carry only the ISO images/packages of the current and the last release. ISO images of older releases are available [here](http://island.quantumachine.net/archive/).
22
23 ## Obtaining source via git
24
25 Since DragonFly 2.1 the source repository is maintained with git instead of CVS. To clone the sources using git:
26
27     # cd /usr
28     # make src-create
29
30 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.
31
32 If you wish to check out the source repository manually, you can use
33
34     # git clone git://git.dragonflybsd.org/dragonfly.git dragonfly
35
36 All release CDs and images also have pkg installed for immediate download of packaged third-party software.
37
38 ## Browsing source via web interface
39
40 The DragonFly source can be browsed via the [gitweb](http://gitweb.dragonflybsd.org/dragonfly.git) web interface.
41
42 ## DragonFly Releases
43
44 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.
45
46 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.
47
48 ## Commercial Sites
49
50 A number of commercial sites selling DragonFly related material is [[here|commercial]].