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.2_REL.img as [bzip2 file](http://mirror-master.dragonflybsd.org/iso-images/dfly-x86_64-5.0.2_REL.img.bz2)
  15
  16 **ISO:**  dfly-x86_64-5.0.2_REL.iso as [bzip2 file](http://mirror-master.dragonflybsd.org/iso-images/dfly-x86_64-5.0.2_REL.iso.bz2)
  17
  18 **Uncompressed ISO:** [dfly-x86_64-5.0.2_REL.iso](http://mirror-master.dragonflybsd.org/iso-images/dfly-x86_64-5.0.2_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 * MD5 (dfly-x86_64-5.0.2_REL.img) = f7324bcac9639f27425b4793912adbbd
  58 * MD5 (dfly-x86_64-5.0.2_REL.img.bz2) = a02acae53865c80c44159dd49790298b
  59 * MD5 (dfly-x86_64-5.0.2_REL.iso) = 717cb73f87a85396bbb1aa55e30048a6
  60 * MD5 (dfly-x86_64-5.0.2_REL.iso.bz2) = 9dde7d927d4df746b2444f8894547467
  61
  62
  63 ### Upgrading
  64
  65 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:
  66
  67     cd /usr/src
  68     git fetch origin
  69     git branch DragonFly_RELEASE_5_0 origin/DragonFly_RELEASE_5_0
  70     git checkout DragonFly_RELEASE_5_0
  71     git pull
  72
  73 And then rebuild: (in /usr/src )
  74
  75     make buildworld
  76     make buildkernel
  77     make installkernel
  78     make installworld
  79     make upgrade
  80
  81 Don't forget to upgrade your existing packages.  5.0 packages have
  82 already been built and are immediately available.
  83
  84     pkg upgrade
  85
  86
  87 ## DragonFly Releases
  88
  89 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.
  90
  91 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.
  92
  93 ## Commercial Sites
  94
  95 A number of commercial sites selling DragonFly related material is [[here|commercial]].