Step by step user guide for STUX GNU/Linux (index)

1. Users and passwords
   
   
   To edit users and passwords:

   STUX CONTROL CENTER -> Setup -> Users and passwords

   The standard KDE users management tool KUSER will open:
   
   
   
   In STUX Live CD, you can manage users and password as in normal linux systems.
   When you need to add a user, edit a user, change or set passwords, you will see a window like this:
   
   
   
   Be sure:
   
   
   • to have setted a 'Login shell' for user.
     
     
     By default 'Login shell' is setted to <Empty>: change this, or user will experience problems, for example, cannot login with FTP.
     /bin/bash is a good value for 'Login shell'.
     
     
   • that account is enabled.
     
     
     By default, the checkbox 'Account disabled' is checked: be sure to uncheck this checkbox in order to let the user login.
     
     
   • When running from Live CD, it's recomended to set 'Home folder' as a directory on a persistent device (example: /mnt/hda2/users), typically an hard disk (a linux filesystem is required, like ext2, ext3, reiserfs, ...): to do this you have to change 'Home folder' from '/home/username' to '/mnt/hda2/users/username'.
   
   NOTE about Live CD usage:
   users and passwords will be restored on reboot only if configuration is saved persistently.
   
   
2. STUX Live CD default users
   
   
   STUX Live CD starts graphical interface (KDE by default) using default user named 'stux'.
   The default user can use the command 'sudo' to gain root access and is member of various groups like 'audio', 'video', 'cdrom', ...
   If the configuration has not been saved persistently, user 'stux' is created before KDE session starts: you can change the name of the STUX default user 'stux' using the boot option:

   stux suser=<user>

   this boot option can be used only from STUX Live CD environmente and only if configuration has not been saved persistently, else the saved default user will be used.
   
   If you saved the Live CD configuration persistently, you can change the default STUX user executing command:

   cd /usr/local/stux-utils/stux-user/
   sudo ./stux-user

   
   
   Be sure that the 'STUX administrator' checkbox is checked.
   
   You can create more default STUX users, but only one can be active.
   
   To restart the session with the new user, log out from KDE and login with the new username (or press ALT+CTRL+BACK to restart KDE directly).
   
   Advanced users could prefer the command line: use command:

   cd /usr/local/stux-utils/stux-user/
   sudo ./set-stux-user.sh

   to get program usage.
   
   
   
3. STUX Live CD default unprivileged users
   
   
   You can also access STUX Live CD using a default user that cannot change system configuration (cannot execute 'sudo', cannot use audio/video peripherals, cannot change network settings, etc.).
   If the configuration has not been saved persistently, it's possible to specify to start KDE with a totally unprivileged user, using the boot option:

   stux user=<user>

   You can change the default STUX unprivileged user executing command:

   cd /usr/local/stux-utils/stux-user/
   sudo ./stux-user

   
   
   Be sure that the 'STUX administrator' checkbox is unchecked.
   
   You can create more default STUX unprivileged users.
   
   To restart the session with the new user, log out from KDE and login with the new username (or pressALT+CTRL+BACK to restart KDE directly).
   
   Advanced users could prefer the command line: use command:

   cd /usr/local/stux-utils/stux-user/
   sudo ./set-stux-user.sh

   to get program usage.