(no commit message)
[ikiwiki.git] / docs / how_to_get_to_the_desktop / index.mdwn
1 # How to get a desktop on DragonFly
2
3 The following page describes the steps need to get to a desktop on DrafonFly.
4
5 [[!toc levels=3 ]]
6
7 ## Prerequisites
8 To get to the desktop you need a working internet connection to download pkgsrc and the packages themselves.
9
10 ## Dealing with pkgsrc 
11
12 ### Installing pkgsrc
13 The basic pkgsrc tools are already provided with every DragonFly default installation, but you still have to download the pkgsrc tree to build and install packages.
14
15 First choose a mirror next to you which provides a git repo containing the pkgsrc tree, you can find them on the [DragonFly mirrors page](http://www.dragonflybsd.org/mirrors/). Next copy the mirrors adress into the Makefile contained in /usr.
16
17 Now execute as root
18
19     #  cd /usr && make pkgsrc-create
20
21 to initally create the pkgsrc tree.
22
23 ### Searching a package
24 Since there are many different packages in the pkgsrc tree you can use a small tool to find the one you are looking for in a short time. For example if you are looking for the ruby package just do
25 # pkg_search ruby
26 and you will get a list of packages containing ruby in their name. If you want to install the ruby-1.9.2pl0 package now, just do
27 # pkg_search -v ruby-1.9.2pl0
28 and you will get the path leading to the package.
29
30 ### Installing a package
31 You got two possibilities to install a package. The first one is to install it from source and the second one is to install prebuild binaries. Depending on your cpu and the size of the package its faster installing binaries, but if you want to change some build options you have to install it by source.
32 If you want to install binaries you only have to use the pkg_radd application. For example to install the xfce4 package just do:
33 # pkg_radd xfce4
34 If you want to install something by source you have to change into the packages directory contained in the pkgsrc tree and execute bmake install clean:
35 # cd /usr/pkgsrc/security/openssh && bmake install clean
36 If you build a package by source you can also change some build options if supported by the package.
37 # cd /usr/pkgsrc/security/openssh && bmake show-options
38 You will get a list of supported options. To change them install the package by:
39 # bmake PKG_OPTIONS.<package_name>="-option1 option2" install clean
40
41 ### Removing a package
42 If you don't need a package anymore and you want to remove it just change into the packages directory and do:
43 # bmake deinstall
44
45 ### Updating packages
46 From time to time you should update your packages, since there will be newer versions with bugfixes or new functionality. There are several methods to update packages but the best one is to use pkg_rolling-replace. You can install it with pkgsrc. After you've done that you'll only have to:
47 # cd /usr && make pkgsrc-update
48 # pkg_rolling-replace -u
49
50 ## The X Window System
51 ### Installing the Server
52 ### Installing appropriate drivers
53 ### Other importan X related packages
54 ### Configuring X
55 ## Installing a Desktop Environment
56 ### KDE
57 ### Xfce4