autologon_unix_lightdm.dita@ 99797

Last change on this file since 99797 was 99797, checked in by vboxsync, 19 months ago
Docs: bugref:10302. Merging changes from the docs team. Almost exclusively conkeyref related stuff.
Property svn:eol-style set to `native` Property svn:keywords set to `Author Date Id Revision`
File size: 6.4 KB

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

Note: See TracBrowser for help on using the repository browser.

Download in other formats:

Original Format