docs/how_to_get_to_the_desktop/index.mdwn

   1 ## Installing a Desktop Environment
   2
   3 This part will explain how to install the desktop environments Lumina,Mate, KDE and Xfce, if you prefer GNOME or a standalone windowmanager you have to read other guides or documentation.
   4
   5 ### Lumina
   6 To install Lumina desktop ( this will install xorg )
   7
   8     # pkg install lumina
   9     # echo 'dbus_enable="YES"' >> /etc/rc.conf
  10
  11 To start, do ether ( in users home dir)
  12
  13     $ echo "exec Lumina-DE" > .xinitrc
  14
  15 or to start xdm
  16
  17     # pkg install xdm
  18     $ echo "exec Lumina-DE" > .xsession
  19
  20 and in /etc/ttys
  21 change off to on in line
  22
  23 ttyv8 " /usr/local.bin/xdm -nodaemon" xterm on secure
  24
  25 (note: putting xdm_enable="YES"  in /etc/rc.conf does not start xdm, the above does)
  26
  27 also note that mouse does not work if using Gnome-Boxes, but does in VirtualBox or VirtualMachine manager
  28
  29 ### Mate
  30 To install Mate simply install the mate meta-packages as root
  31
  32     # pkg install mate
  33
  34 Edit /etc/rc.conf
  35
  36     dbus_enable="YES"
  37     hald_enable="YES"
  38
  39 Edit in home user .xinitrc
  40
  41      exec mate-session
  42
  43 or to start xdm
  44      # pkg install xdm
  45      $ echo "exec mate-session" > .xsession
  46
  47 ### KDE
  48
  49 KDE stands for K Desktop Environment, its a modern desktop environment, based on Nokia's QT-Framework, with many nice applications. If your computer has less than 1Gb RAM you should better install Xfce4 described later in this guide.
  50 Since the KDE and QT packages are pretty huge you can save much time when using binary packages.
  51 There are 2 different KDE meta-packages available: KDE3 and KDE4 . KDE3 is the older, but more stable release while KDE4 has many new features but also new bugs. So it's on you to decide which one you want to install.
  52 For KDE3 simply do as root
  53
  54     # pkg_radd kde3
  55
  56 For KDE4
  57
  58     # pkg_radd kde4
  59
  60 Now that you have installed KDE we still need to start it.
  61 As user edit your ~/.xinitrc and comment the exec xterm part out and add exec startkde.
  62 Now start it with executing startx as user. If everything works well you should see a standard KDE desktop, you now can explore ist or read documentation to see what you can do with it.
  63
  64 Some users may prefer a graphical log in, KDE provides it's own display manager for them: kdm. It looks better than the X display manager xdm and provides more options. To start it at boot time simply change your ttyv8 line in /etc/ttys to ttyv8 “/usr/pkg/bin/kdm -nodaemon” xterm on secure .
  65
  66 ### Xfce4
  67 Xfce is a lightweight desktop environment using the GTK+ toolkit (like GNOME) it has less applications than KDE but if your computer isn't that good it's the better choice.
  68 To install Xfce4 simply install the xfce4 and xfce4- meta-packages as root
  69
  70     # pkg_radd xfce4 && pkg_radd xfce4-extras
  71 or if you want to compile them yourself
  72
  73     # cd /usr/pkgsrc/meta-pkgs/xfce4 && bmake install clean
  74     # cd /usr/pkgsrc/meta-pkgs/xfce4-extras && bmake install clean
  75
  76 To test if it works edit your ~/.xinitrc as user, comment the exec xterm part out and add exec startxfce4.
  77 Since Xfce doesnt have its own display manager for a graphical login so you have to install one yourself. You could either install xdm, kdm or gdm. Gdm is the GNOME display manager and also uses the GTK+ toolkit so it's a good choice for Xfce, too.
  78 Install gdm by executing
  79
  80     # pkg_radd gdm
  81
  82 or
  83
  84     # cd /usr/pkgsrc/x11/gdm && bmake install
  85
  86 To start it at boot time you can simply add gdm_enable=”YES” to your /etc/rc.conf
  87
  88 # How to continue?
  89 Now after you installed the basic desktop you may wish to add additional applications such as a browser like firefox:
  90
  91     # pkg_radd firefox
  92
  93 You are fully free what to do now and pkgsrc offers a lot of desktop packages you could install. Have fun with your desktop!
  94
  95 # How to get a desktop on DragonFly
  96
  97 **This topic is wildly out of date for example the command pkg_radd is no longer used, and the pkg install command is used instead. **
  98
  99  It is also mostly redundant as it covers the same ground as the "installing and configuring X" topic [in the new handbook, which is located here](/docs/newhandbook/X).
 100
 101 [[!toc levels=3 ]]
 102
 103 ## Prerequisites
 104 To get to the desktop you need a working internet connection to download pkgsrc and the packages themselves.
 105
 106 ## Dealing with pkgsrc
 107
 108 ### Installing pkgsrc
 109 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.
 110
 111 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.
 112
 113 Now execute as root
 114
 115     # cd /usr && make pkgsrc-create
 116
 117 to initally create the pkgsrc tree.
 118
 119 ### Searching a package
 120 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
 121
 122     # pkg_search ruby
 123
 124 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
 125
 126     # pkg_search -v ruby-1.9.2pl0
 127
 128 and you will get the path leading to the package.
 129
 130 ### Installing a package
 131 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.
 132 If you want to install binaries you only have to use the pkg_radd application. For example to install the xfce4 package just do:
 133
 134     # pkg_radd xfce4
 135
 136 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:
 137
 138     # cd /usr/pkgsrc/security/openssh && bmake install clean
 139
 140 If you build a package by source you can also change some build options if supported by the package.
 141
 142     # cd /usr/pkgsrc/security/openssh && bmake show-options
 143
 144 You will get a list of supported options. To change them install the package by:
 145
 146     # bmake PKG_OPTIONS.<package_name>="-option1 option2" install clean
 147
 148
 149 ### Removing a package
 150 If you don't need a package anymore and you want to remove it just change into the packages directory and do:
 151
 152     # bmake deinstall
 153
 154
 155 ### Updating packages
 156 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:
 157
 158     # cd /usr && make pkgsrc-update
 159     # pkg_rolling-replace -u
 160
 161 ## The X Window System
 162 ### Installing the Server
 163 The installation of the X Window System contains a few steps. We will start with the most basic one: Installing the X-Server.
 164 To do so you have to execute as root
 165
 166     # cd /usr/pkgsrc/x11/modular-xorg-server && bmake install clean
 167
 168 or if you want to install it as a binary
 169
 170     # pkg_radd modular-xorg-server
 171
 172 ### Installing appropriate drivers
 173 You now need some input drivers and a video driver for your video card.
 174 If you want to install all input and video drivers so you can test them out install the modular-xorg-drivers package
 175
 176     # cd /usr/pkgsrc/meta-pkgs/modular-xorg-drivers && bmake install clean
 177
 178 or if you want to install them as binaries
 179
 180     # pkg_radd modular-xorg-drivers
 181
 182 If you know which drivers you need install them on your own needs. They can be found in /usr/pkgsrc/x11/ and are named xf86-<video or input>-<driver name>
 183
 184 ### Other importan X related packages
 185 Now we will install other important packages for X. We will need some additional libraries
 186
 187     # cd /usr/pkgsrc/meta-pkgs/modular-xorg-libs && bmake install clean
 188
 189 or if you want to install them as binaries
 190
 191     # pkg_radd modular-xorg-libs
 192
 193 Next we'll need some fonts
 194
 195     # cd /usr/pkgsrc/meta-pkgs/modular-xorg-fonts && bmake install clean
 196
 197 or if you want to install them as binaries
 198
 199     # pkg_radd modular-xorg-fonts
 200
 201 Last package we need contains some useful applications like xterm and startx
 202
 203     # cd /usr/pkgsrc/meta-pkgs/modular-xorg-apps && bmake install clean
 204
 205 or if you want to install them as binaries
 206
 207     # pkg_radd modular-xorg-apps
 208
 209 ### Configuring X
 210 Since we have installed all necessary packages now we have to configure X so it works like we want it. First execute as root
 211
 212     # Xorg -configure
 213     # cp /root/xorg.conf.new /etc/X11/xorg.conf
 214
 215 Now we have a basic configuration file for X.
 216 As normal user now create a file named ~/.xinitrc and write exec xterm in it. Now make it executable
 217
 218     # chmod +x ~/.xinitrc
 219
 220 Now you can try to start the X server by doing
 221
 222     # startx
 223
 224 as normal user.
 225 If everything works well you should see a white terminal and should be able to mover your mouse. Click into the terminal and test you keyboard layout. Now type exit into the terminal and you will return to TTY. If everything worked well you can continue with installing a desktop environment, if not you have to manually edit /etc/X11/xorg.conf . Also check the X.org documentation and the DragonFly handbook, where you may find a solution to your problem.