debian/README.Debian: Add file. Explain steps to complete configuration of desktop-autoloader on Debian systems.

1 files changed, 39 insertions, 0 deletions

diff --git a/debian/README.Debian b/debian/README.Debian
new file mode 100644
index 0000000..168313e
--- /dev/null
+++ b/debian/README.Debian
@@ -0,0 +1,39 @@
+# Desktop Session Autoloader in Debian
+
+This package brings to you the desktop-autoloader for your Debian system.
+For some info about the general concept, refer to upstream's README.md.
+
+## Auto-Loading the correct Desktop Environment
+
+For taking Desktop Session Autoloader into production, please make sure
+
+  /etc/default/desktop-autoloader
+
+is configured correctly. Esp. make sure that the correct desktop
+environment gets autoloaded.
+
+## Customizing Application Auto-Loading
+
+Next, please check the .desktop files in the folder
+/etc/desktop-autoloader/autostart/. By default, there is only one file
+(sleep-and-kill.desktop). Do not remove that file from there.
+
+Additionally, you should place your users' favourite applications in that
+folder. Simply symlink them from /usr/share/applications/, e.g.:
+
+  ln -s /usr/share/applications/firefox-esr.desktop /etc/desktop-autoloader/autostart/
+
+## Adapting Desktop Session Autoloader to your Site's Schedule
+
+Also consider adapting the time interval of the @reboot CRON job that
+launches desktop-autoloader (see
+
+  /etc/cron.d/desktop-autoloader
+
+). You need to boot machines (via UEFI Wakeup RTC or Wake-on-LAN) before
+the time interval given in the CRON job file. Only then, the
+desktop-autoloader kicks in.
+
+Also make sure that the desktop-autoloader does _NOT_ kick in once people
+have started using the computers on site. This may vary depending on your
+institution.