=== Welcome to the Linutop OS 3.1.1 === Linutop OS 3.1.1 is a set of open source softwares based on the GNU/Linux Ubuntu distribution. 1. Configuration ================ The Linutop Setup tool starts at the end of the first boot, allowing to setup the Linutop system. It can also be accessed from the 'Settings' menu. 1.1 Standard settings --------------------- The first tab of this tool let you choose your local settings: - language - keyboard layout - time zone The language setting will be applied after a reboot. By default the system will try to guess the informations about your screen, but you can force the resolution you want in the display settings. 1.2 Network settings -------------------- The second tab lets you define some network properties. By default the network uses DHCP to connect to a local network and/or internet, and no action from your part should be needed. But you might need to define a fix IP address or a WEP security key. This is possible with the network settings dialog. You can choose to enable Network Manager, a handy tool to configure WiFi connections. You can also make the system use Windows shared folders. All you need to do is to define them in the 'Windows shares' frame. The system will set them up automatically at each boot. 1.3 Advanced ------------ By default the Linutop OS only stores user configuration and data (wallpaper, icons, documents created on the Linutop...), but doesn't store changes done to the system (settings, added applications...). This means that after a reboot, the system will be in it's original working state. You can change this behaviour in the 'advanced' tab of the configuration tool ('Data persistence' frame). - 'user settings only persistence' is the default behaviour; - 'full persistent system' means that everything you do on the system will be kept after a reboot. If a problem happens you can restore your system (see the 'Boot' paragraph). 1.4 Security ------------ The lock mode allows to set up a customized and secured system at the same time. It can be set in 2 steps: - switch to the persistent mode to set up the system (add applications, edit the default settings, change the system configuration...). You'll have to define a password to protect the system. - switch to lock mode ('Security' tab of the configuration tool). After a reboot, running an administration tool will prompt for the password you defined earlier. All the data will be written in RAM, so a simple reboot of the Linutop will restore the system to its previous configuration step. To unlock the system, run the configuration tool and deactivate the lock mode in the 'Security' tab. For detailed informations see http://linutop.com/wiki/index.php/Modes/Lock. 2. Linutop Tools ================ 2.1 Backup/Restore ------------------ We highly recommend to do a backup of your system before starting tweaking it. A backuped system can be easily restored. A backup can be done using the 'Linutop Backup' tool in the 'System' menu. All you need is an USB key (1 Go minimum). Plug it in and run the backup tool. If you choose to create a full copy of the system, additional settings will also be written on the target USB key (additional programs installed, user settings...). Restoring the system is as simple as backuping it. Boot on the backup USB key, and use the same tool to duplicate the system on the internal drive. You can also use the command line scripts. For instance: sudo lusm -d /dev/sdb # duplicate the system on /dev/sdb sudo lusm-backup -d/ dev/sdb # also duplicate the settings You can also create a new system from an online image. To install the current stable release on /dev/sdb, use: sudo lusm-web -d /dev/sdb current2 You can also specify a custom URL (without it lusm-web will try to get the image from the linutop servers): sudo lusm-web -d /dev/sdb http://192.168.1.3/linutop-image 2.2 Autostarted applications ---------------------------- The 'appstarter' software provides a very easy way to select which application has to be run at startup. Configure it once, and you will never have to use a keyboard or mouse on the lintuop if you use it for digital signage for instance. You can run appstarter from the 'System' menu ('Startup' item) or from the main tab of the configuration tool. If you chose to not start the desktop, you can revert this setting using the following steps: - hit alt+F2 - in the dialog appearing type 'appstarter' and hit 'enter' - remove the option in the application 3. Boot options =============== 3.1 Linutop OS -------------- To restore the initial state of the linutop OS, keep the 'escape' key pressed during the boot. A prompt will appear. Type 'restore' and hit enter to erase all the data written. WARNING: no confirmation will be asked, be sure to know what you're doing. To boot in failsafe mode, use the 'failsafe' keyword instead. The Linutop will boot with the default settings. 3.2 Services ------------ System services (daemons) can be blacklisted if you don't want to start them during boot. This can be done using the 'services-blacklist' command line tool. To blacklist a service use: sudo services-blacklist add service1 service2 To restore a service use: sudo services-blacklist del service3 service4 Some services are disabled by default. To list the blacklisted services use: sudo services-blacklist list BE CAREFULL. Disabling the wrong services might prevent the system of correctly booting. 4. Online documentation ======================= * Linutop website: http://linutop.com * Linutop Wiki: http://linutop.com/wiki/index.php/Main_Page * Xfce Desktop: http://www.xfce.org/documentation/4.2/ (or file:///usr/share/xfce4/doc/C/index.html) Enjoy your linutop! FAQ === Q: Can I disable the screensaver? A: Choose the 'Settings Manager' in the 'Settings' submenu, click on the 'Screensaver' icon, set the Mode to 'Disable Screen Saver' Q: ctrl+v and ctrl+c don't work in a terminal for copy/paste, how come? A: You need to use ctrl+shift+v and ctrl+shift+c. Note that any selected text can be copied by clicking the mouse middle button (or on left and right button at the same time). Q: How can I take a screenshot? A: Use the 'print screen' key to take a snapshot of the whole screen, and alt + 'print screen' to take a snapshot of the active window. Q: I can't see the entire window of an application. How can I move it? A: Keep the alt key pressed and drag the window with the mouse. Q: Now I'm prompted a login and password, what should I use? A: The login is 'linutop' and the password is blank (if you've not activated the lock mode). Q: How can I get my Linutop IP address? A: You have two solutions: - start the Linutop Setup application, the IP address is displayed in the 'About' tab - in a Terminal, type the following command: ifconfig Q: Can I use the RDP protocol to access my Windows Desktop? A: Yes. The 'Terminal Server Client' software ('Network' menu) allows you to connect to a Windows server. You can also use the 'rdesktop' command line tool (to autostart the connection for instance): rdesktop -a 16 -g 1024x768 192.168.0.3 More informations on http://www.linutop.com/wiki/index.php/RDP Q: Can I access a VNC server? A: Yes. 'Terminal Server Client' also allows to connect to a VNC server. You can also use the command line tool: xvncviewer 192.168.0.3:1 More informations on http://www.linutop.com/wiki/index.php/VNC Q: How should I prepare an external HD to be able to write on it? A: In the the Partition Manager choose to create a Fat32 filesystem on the disk. This file system can be read by all the operating systems (Linux, Windows, MacOS). If you want to write on an ext2 or ext3 partition, you need to change the owner of the files with the following command: sudo chown linutop:linutop /media/disk Q: How can I find Digital TV (DVB-T) channels? A: Plug in your USB dongle first, then run the scanner. In a Terminal type: scandvbt Once VLC has started, you can edit and save the list of channels as a playlist.