[[!meta title="Obtaining DragonFly for your system"]]

[[!toc  levels=3]]

## Images

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`. 

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/). 

### Download live image 64-bit
DragonFly BSD is 64-bit only, as announced during the 3.8 release.

**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)

**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)
 
**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.)

Daily **SNAPSHOT**: [here](http://mirror-master.dragonflybsd.org/snapshots/)  

**MD5 checksums** for all release images [are available](http://avalon.dragonflybsd.org/iso-images/md5.txt).

Here is a list of [[**worldwide mirrors**|/mirrors]] offering DragonFly ISO images.  *Please use an appropriate mirror for best results!*

## Release Notes

For more details, read the 5.0 [[release notes|release50]].

## Obtaining source via git

Since DragonFly 2.1 the source repository is maintained with git instead of CVS. To clone the sources using git:

    # cd /usr
    # make src-create

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.

If you wish to check out the source repository manually, you can use

    # git clone git://git.dragonflybsd.org/dragonfly.git dragonfly

All release CDs and images also have pkg installed for immediate download of packaged third-party software.

## Browsing source via web interface

The DragonFly source can be browsed via the [gitweb](http://gitweb.dragonflybsd.org/dragonfly.git) web interface.

## Upgrade

### Checksums

* MD5 (dfly-x86_64-5.0.1_REL.img) = ee8f70c1b1996189288a9a40504bd76e
* MD5 (dfly-x86_64-5.0.1_REL.iso) = 2f59975fce621af34466d5b8f752cc4c
* MD5 (dfly-x86_64-5.0.1_REL.img.bz2) = 41c16ee6799652962636c30c3ce2c2f7
* MD5 (dfly-x86_64-5.0.1_REL.iso.bz2) = b3267402ab3db54f096e9c63d343b58d
* MD5 (dfly-x86_64-5.0.2_REL.img) = f7324bcac9639f27425b4793912adbbd
* MD5 (dfly-x86_64-5.0.2_REL.img.bz2) = a02acae53865c80c44159dd49790298b
* MD5 (dfly-x86_64-5.0.2_REL.iso) = 717cb73f87a85396bbb1aa55e30048a6
* MD5 (dfly-x86_64-5.0.2_REL.iso.bz2) = 9dde7d927d4df746b2444f8894547467


### Upgrading

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:

    cd /usr/src
    git fetch origin
    git branch DragonFly_RELEASE_5_0 origin/DragonFly_RELEASE_5_0
    git checkout DragonFly_RELEASE_5_0
    git pull

And then rebuild: (in /usr/src )

    make buildworld
    make buildkernel
    make installkernel
    make installworld
    make upgrade

Don't forget to upgrade your existing packages.  5.0 packages have
already been built and are immediately available.

    pkg upgrade


## DragonFly Releases

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.

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.

## Commercial Sites

A number of commercial sites selling DragonFly related material is [[here|commercial]].