download.mdwn

   1 [[!meta title="Obtaining DragonFly for your system"]]
   2
   3 [[!toc  levels=3]]
   4
   5 ## Images
   6
   7 DragonFly BSD 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 the current release.  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 ### Download live image 64-bit
  12 DragonFly BSD is 64-bit only, as announced during the 3.8 release.
  13
  14 **USB:**  dfly-x86_64-5.0.1_REL.img as [bzip2 file](http://mirror-master.dragonflybsd.org/iso-images/dfly-x86_64-5.0.1_REL.img.bz2)
  15
  16 **ISO:**  dfly-x86_64-5.0.1_REL.iso as [bzip2 file](http://mirror-master.dragonflybsd.org/iso-images/dfly-x86_64-5.0.1_REL.iso.bz2)
  17
  18 **Uncompressed ISO:** [dfly-x86_64-5.0.1_REL.iso](http://mirror-master.dragonflybsd.org/iso-images/dfly-x86_64-5.0.1_REL.iso) (For use with VPS providers as an install image.)
  19
  20 Daily **SNAPSHOT**: [here](http://mirror-master.dragonflybsd.org/snapshots/)
  21
  22 **MD5 checksums** for all release images [are available](http://avalon.dragonflybsd.org/iso-images/md5.txt).
  23
  24 Here is a list of [[**worldwide mirrors**|/mirrors]] offering DragonFly ISO images.  *Please use an appropriate mirror for best results!*
  25
  26 ## Release Notes
  27
  28 For more details, read the 5.0 [[release notes|release50]].
  29
  30 ## Obtaining source via git
  31
  32 Since DragonFly 2.1 the source repository is maintained with git instead of CVS. To clone the sources using git:
  33
  34     # cd /usr
  35     # make src-create
  36
  37 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 dports (`devel/git`). See [development(7)](http://leaf.dragonflybsd.org/cgi/web-man?command=development&section=ANY") for further instructions how to work with the repository.
  38
  39 If you wish to check out the source repository manually, you can use
  40
  41     # git clone git://git.dragonflybsd.org/dragonfly.git dragonfly
  42
  43 All release CDs and images also have pkg installed for immediate download of packaged third-party software.
  44
  45 ## Browsing source via web interface
  46
  47 The DragonFly source can be browsed via the [gitweb](http://gitweb.dragonflybsd.org/dragonfly.git) web interface.
  48
  49 ## Upgrade
  50
  51 ### Checksums
  52
  53 MD5 (dfly-x86_64-5.0.1_REL.img) = ee8f70c1b1996189288a9a40504bd76e
  54 MD5 (dfly-x86_64-5.0.1_REL.iso) = 2f59975fce621af34466d5b8f752cc4c
  55 MD5 (dfly-x86_64-5.0.1_REL.img.bz2) = 41c16ee6799652962636c30c3ce2c2f7
  56 MD5 (dfly-x86_64-5.0.1_REL.iso.bz2) = b3267402ab3db54f096e9c63d343b58d
  57
  58 ### Upgrading
  59
  60 If you have an existing 4.8.x system and are running a generic kernel, the normal upgrade process will work.  Change your local /usr/src to 5.0:
  61
  62     cd /usr/src
  63     git fetch origin
  64     git branch DragonFly_RELEASE_5_0 origin/DragonFly_RELEASE_5_0
  65     git checkout DragonFly_RELEASE_5_0
  66     git pull
  67
  68 And then rebuild: (in /usr/src )
  69
  70     make buildworld
  71     make buildkernel
  72     make installkernel
  73     make installworld
  74     make upgrade
  75
  76 Don't forget to upgrade your existing packages.  5.0 packages have
  77 already been built and are immediately available.
  78
  79     pkg upgrade
  80
  81
  82 ## DragonFly Releases
  83
  84 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.
  85
  86 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.
  87
  88 ## Commercial Sites
  89
  90 A number of commercial sites selling DragonFly related material is [[here|commercial]].