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. You could also try [Image Writer for Windows](http://sourceforge.net/projects/win32diskimager/files/).
  10
  11 Be sure to check the [[release notes|release34]].
  12
  13 **x86_64:** [CD](http://mirror-master.dragonflybsd.org/iso-images/dfly-x86_64-3.4.2_REL.iso.bz2) |  [USB](http://mirror-master.dragonflybsd.org/iso-images/dfly-x86_64-3.4.2_REL.img.bz2)|  [GUI ISO](http://mirror-master.dragonflybsd.org/iso-images/dfly-x86_64-gui-3.4.2_REL.iso.bz2) | [GUI USB](http://mirror-master.dragonflybsd.org/iso-images/dfly-x86_64-gui-3.4.2_REL.img.bz2)
  14
  15 The i386 architecture has significant limitations compared to x86_64. These images are only recommended for use with legacy computers incapable of running 64-bit software
  16
  17 **i386:** [CD](http://mirror-master.dragonflybsd.org/iso-images/dfly-i386-3.4.2_REL.iso.bz2) |  [USB](http://mirror-master.dragonflybsd.org/iso-images/dfly-i386-3.4.2_REL.img.bz2) |  [GUI ISO](http://mirror-master.dragonflybsd.org/iso-images/dfly-i386-gui-3.4.2_REL.iso.bz2) |  [GUI USB](http://mirror-master.dragonflybsd.org/iso-images/dfly-i386-gui-3.4.2_REL.img.bz2)
  18
  19 Daily **SNAPSHOT**: [here](http://mirror-master.dragonflybsd.org/snapshots/)  Snapshots use the new packaging system 'dports'.
  20
  21 Here is a list of [[**worldwide mirrors**|/mirrors]] offering DragonFly ISO images.  *Please use an appropriate mirror for best results!*
  22
  23 ### Legacy Releases
  24
  25 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/).
  26
  27 ## Binary pkgsrc packages
  28
  29 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.
  30
  31 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`
  32
  33 To obtain the pkgsrc tree via git:
  34
  35     # cd /usr
  36     # make pkgsrc-create
  37
  38 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:
  39
  40     # cd /usr
  41     # chmod u+w Makefile
  42     # perl -i -ne 's/pkgsrc\.git/pkgsrcv2.git/;print' Makefile
  43     # chmod u-w Makefile
  44     # make pkgsrc-create
  45
  46
  47 ## Obtaining source via git
  48
  49 Since DragonFly 2.1 the source repository is maintained with git instead of CVS. To clone the sources using git:
  50
  51     # cd /usr
  52     # make src-create
  53
  54 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.
  55
  56 If you wish to check out the source repository manually, you can use
  57
  58     # git clone git://git.dragonflybsd.org/dragonfly.git dragonfly
  59
  60 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.
  61
  62 ## Browsing source via web interface
  63
  64 The DragonFly source can be browsed via the [gitweb](http://gitweb.dragonflybsd.org/dragonfly.git) web interface.
  65
  66 ## DragonFly Releases
  67
  68 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.
  69
  70 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.
  71
  72 ## Commercial Sites
  73
  74 A number of commercial sites selling DragonFly related material is [[here|commercial]].