| 1 | <?xml version='1.0' encoding='UTF-8'?>
|
|---|
| 2 | <!DOCTYPE topic PUBLIC "-//OASIS//DTD DITA Topic//EN" "topic.dtd">
|
|---|
| 3 | <topic xml:lang="en-us" id="autologon_unix_lightdm">
|
|---|
| 4 | <title><ph conkeyref="vbox-conkeyref-phrases/product-name"/> Greeter for Ubuntu/LightDM</title>
|
|---|
| 5 |
|
|---|
| 6 | <body>
|
|---|
| 7 | <p><ph conkeyref="vbox-conkeyref-phrases/product-name"/> comes with a greeter module, named
|
|---|
| 8 | <userinput>vbox-greeter</userinput>, that can be used with LightDM. LightDM is the default display manager for
|
|---|
| 9 | Ubuntu Linux and therefore can also be used for automated guest logins. </p>
|
|---|
| 10 | <p><userinput>vbox-greeter</userinput> does not need the
|
|---|
| 11 | <userinput>pam_vbox</userinput> module described in
|
|---|
| 12 | <xref href="autologon_unix.dita#autologon_unix"/>in order to function. It comes
|
|---|
| 13 | with its own authentication mechanism provided by LightDM.
|
|---|
| 14 | However, to provide maximum flexibility both modules can be
|
|---|
| 15 | used together on the same guest.
|
|---|
| 16 | </p>
|
|---|
| 17 | <p>As with the <userinput>pam_vbox</userinput> module, <userinput>vbox-greeter</userinput> is shipped as part of the
|
|---|
| 18 | Guest Additions but it is not installed or activated on the guest OS by default. To install
|
|---|
| 19 | <userinput>vbox-greeter</userinput> automatically upon Guest Additions installation, use the
|
|---|
| 20 | <codeph>--with-autologon</codeph> option when starting the <userinput>VBoxLinuxAdditions.run</userinput> file: </p>
|
|---|
| 21 | <pre xml:space="preserve"># ./VBoxLinuxAdditions.run -- --with-autologon</pre>
|
|---|
| 22 | <p>For manual or postponed installation, copy the <filepath>vbox-greeter.desktop</filepath> file from
|
|---|
| 23 | <filepath>/opt/VBoxGuestAdditions-<varname>version</varname>/other/</filepath> to the
|
|---|
| 24 | <filepath>xgreeters</filepath> directory, which is usually <filepath>/usr/share/xgreeters/</filepath>. See your
|
|---|
| 25 | guest OS documentation for the name of the correct LightDM greeter directory. </p>
|
|---|
| 26 | <p>The <userinput>vbox-greeter</userinput> module is installed by the <ph
|
|---|
| 27 | conkeyref="vbox-conkeyref-phrases/product-name"/> Guest Additions installer and is located in
|
|---|
| 28 | <filepath>/usr/sbin/</filepath>. To enable <userinput>vbox-greeter</userinput> as the standard greeter module,
|
|---|
| 29 | edit the file <filepath>/etc/lightdm/lightdm.conf</filepath> as follows: </p>
|
|---|
| 30 | <pre xml:space="preserve">[SeatDefaults]
|
|---|
| 31 | greeter-session=vbox-greeter</pre>
|
|---|
| 32 | <note>
|
|---|
| 33 | <ul>
|
|---|
| 34 | <li>
|
|---|
| 35 | <p>The LightDM server must be fully restarted in order for <userinput>vbox-greeter</userinput> to be used as
|
|---|
| 36 | the default greeter. As <codeph>root</codeph> on Ubuntu, run <userinput>service lightdm
|
|---|
| 37 | --full-restart</userinput> or restart the guest. </p>
|
|---|
| 38 | </li>
|
|---|
| 39 | <li>
|
|---|
| 40 | <p><userinput>vbox-greeter</userinput> is independent of the
|
|---|
| 41 | graphical session you choose, such as Gnome, KDE, or
|
|---|
| 42 | Unity. However, <userinput>vbox-greeter</userinput> does
|
|---|
| 43 | require FLTK 1.3 or later to implement its own user
|
|---|
| 44 | interface.
|
|---|
| 45 | </p>
|
|---|
| 46 | </li>
|
|---|
| 47 | </ul>
|
|---|
| 48 | </note>
|
|---|
| 49 | <p>There are numerous guest properties which can be used to further customize the login experience. For
|
|---|
| 50 | automatically logging in users, the same guest properties apply as for <userinput>pam_vbox</userinput>. See <xref
|
|---|
| 51 | href="autologon_unix.dita#autologon_unix"/>. </p>
|
|---|
| 52 | <p>In addition to the previously mentioned guest properties, <userinput>vbox-greeter</userinput> enables you to
|
|---|
| 53 | further customize its user interface. The following guest properties are located in the
|
|---|
| 54 | <filepath>/VirtualBox/GuestAdd/Greeter/</filepath> directory: </p>
|
|---|
| 55 | <ul>
|
|---|
| 56 | <li>
|
|---|
| 57 | <p><codeph>HideRestart</codeph>: Set to 1 if
|
|---|
| 58 | <userinput>vbox-greeter</userinput> should hide the button to
|
|---|
| 59 | restart the guest. This property must be set read-only for
|
|---|
| 60 | the guest (<codeph>RDONLYGUEST</codeph>).
|
|---|
| 61 | </p>
|
|---|
| 62 | </li>
|
|---|
| 63 | <li>
|
|---|
| 64 | <p><codeph>HideShutdown</codeph>: Set to 1 if
|
|---|
| 65 | <userinput>vbox-greeter</userinput> should hide the button to
|
|---|
| 66 | shutdown the guest. This property must be set read-only
|
|---|
| 67 | for the guest (<codeph>RDONLYGUEST</codeph>).
|
|---|
| 68 | </p>
|
|---|
| 69 | </li>
|
|---|
| 70 | <li>
|
|---|
| 71 | <p><codeph>BannerPath</codeph>: Path to a
|
|---|
| 72 | <filepath>.PNG</filepath> file to use as a banner image on
|
|---|
| 73 | the top of the greeter. The image size must be 460 x 90
|
|---|
| 74 | pixels, any bit depth. This property must be set read-only
|
|---|
| 75 | for the guest (<codeph>RDONLYGUEST</codeph>).
|
|---|
| 76 | </p>
|
|---|
| 77 | </li>
|
|---|
| 78 | <li>
|
|---|
| 79 | <p><codeph>UseTheming</codeph>: Set to 1 for turning on the
|
|---|
| 80 | following theming options. This property must be set
|
|---|
| 81 | read-only for the guest (<codeph>RDONLYGUEST</codeph>).
|
|---|
| 82 | </p>
|
|---|
| 83 | </li>
|
|---|
| 84 | <li>
|
|---|
| 85 | <p><codeph>Theme/BackgroundColor</codeph>: Hexadecimal
|
|---|
| 86 | RRGGBB color for the background. This property must be set
|
|---|
| 87 | read-only for the guest (<codeph>RDONLYGUEST</codeph>).
|
|---|
| 88 | </p>
|
|---|
| 89 | </li>
|
|---|
| 90 | <li>
|
|---|
| 91 | <p><codeph>Theme/LogonDialog/HeaderColor</codeph>:
|
|---|
| 92 | Hexadecimal RRGGBB foreground color for the header text.
|
|---|
| 93 | This property must be set read-only for the guest
|
|---|
| 94 | (<codeph>RDONLYGUEST</codeph>).
|
|---|
| 95 | </p>
|
|---|
| 96 | </li>
|
|---|
| 97 | <li>
|
|---|
| 98 | <p><codeph>Theme/LogonDialog/BackgroundColor</codeph>:
|
|---|
| 99 | Hexadecimal RRGGBB color for the login dialog background.
|
|---|
| 100 | This property must be set read-only for the guest
|
|---|
| 101 | (<codeph>RDONLYGUEST</codeph>).
|
|---|
| 102 | </p>
|
|---|
| 103 | </li>
|
|---|
| 104 | <li>
|
|---|
| 105 | <p><codeph>Theme/LogonDialog/ButtonColor</codeph>:
|
|---|
| 106 | Hexadecimal RRGGBB background color for the login dialog
|
|---|
| 107 | button. This property must be set read-only for the guest
|
|---|
| 108 | (<codeph>RDONLYGUEST</codeph>).
|
|---|
| 109 | </p>
|
|---|
| 110 | </li>
|
|---|
| 111 | </ul>
|
|---|
| 112 | <note>
|
|---|
| 113 | <p>The same restrictions for the guest properties above apply as for the ones specified in the
|
|---|
| 114 | <codeph>pam_vbox</codeph> section. </p>
|
|---|
| 115 | </note>
|
|---|
| 116 | </body>
|
|---|
| 117 |
|
|---|
| 118 | </topic>
|
|---|
