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.0_REL.img) = 0b37697389e4dc7380ad4dee1cadf9b0
  54     MD5 (dfly-x86_64-5.0.0_REL.iso) = 599d5e151c0315c1112f7585a8265faf
  55     MD5 (dfly-x86_64-5.0.0_REL.img.bz2) = b40b76dbdd88cafb8db85bc74a7e438f
  56     MD5 (dfly-x86_64-5.0.0_REL.iso.bz2) = 22ecc945e0aacd1bb2ea2318b428a9b0
  57
  58
  59 ### Upgrading
  60
  61 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:
  62
  63     cd /usr/src
  64     git fetch origin
  65     git branch DragonFly_RELEASE_5_0 origin/DragonFly_RELEASE_5_0
  66     git checkout DragonFly_RELEASE_5_0
  67     git pull
  68
  69 And then rebuild: (in /usr/src )
  70
  71     make buildworld
  72     make buildkernel
  73     make installkernel
  74     make installworld
  75     make upgrade
  76
  77 Don't forget to upgrade your existing packages.  5.0 packages have
  78 already been built and are immediately available.
  79
  80     pkg upgrade
  81
  82
  83 ## DragonFly Releases
  84
  85 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.
  86
  87 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.
  88
  89 ## Commercial Sites
  90
  91 A number of commercial sites selling DragonFly related material is [[here|commercial]].