Install ======= .. contents:: Table of contents :backlinks: none First install ------------- GNU/Linux ~~~~~~~~~ - Check its md5sum and compare to the one of `Sage Debian Live website `_ by typing :: md5sum 2018-*-debian-stretch-live-*.img - Burn the img image on your USB key: if ``/dev/sdX`` (usually ``/dev/sdb`` or ``/dev/sdc``) is the device of your empty USB key (at least 4GB), then type as root:: dd if=2018-*-debian-stretch-live-*.img of=/dev/sdX bs=1M - By default, the key has almost no free space for your personal data, but the keys that will be cloned from it will use the whole space, see the replicating_ section. If you still want to enlarge your first key, use gparted_ to extend the live ``vfat`` partition to the size of the key, then update the bootloader by typing as root:: syslinux -d /live/syslinux /dev/sdX1 Windowz ~~~~~~~ - Check and burn the img image on your USB key: use `Image Writer for Windows `_ - "Image file" is where the ``.img`` file you just uncompressed is. - "Device" is the name of the disk of your USB key (e.g. ``F:\`` ). - Click on "MD5 Hash:" to compute the md5sum and compare it to the one of `Sage Debian Live website `_. - Click on "Write" to copy the image on the USB key (this may take a while). - By default, the key has almost no free space for your personal data, but the keys that will be cloned from it will use the whole space, see the replicating_ section. OS X ~~~~ Mac computers require that the USB key if formatted with a GUID partition type to be able to boot on them, which is not the case for Sage Debian Live. Hence, you should use a CD bootloader to boot from the USB key: - Build and resize the USB key as explained in the GNU/Linux paragraph (if the ``dd`` command does not work, replace ``bs=1M`` by ``bs=1m`` at the end of it). - Burn a CD with the plopkexec.iso_ image from the download page. See the boot_ section to know how to boot on Macs. Boot ---- PC ~~ You should tell the BIOS of your computer to boot from the USB key and not from the hard disk first. For this, you should enter the BIOS settings by by pressing F2 or F12 key during the boot (sometimes the key is "Escape", "DEL", F9, F10, F11, test them all until you see the BIOS screen). Then look for some "boot order" section, select and move the USB key before the hard disk. Search the web for pictures if this is not clear. If the BIOS of your computer is not able to boot from the USB key, - burn a CD with the plopkexec.iso_ image from the download page. - ask the BIOS to boot on the CD first (same procedure as for the USB key). - boot on the CD with the USB key plugged on the computer. .. _boot: Mac ~~~ On a Mac, insert both the CD and the USB key, boot the computer by pressing either "C" or the "Option" key, and follow the instructions. .. _plopkexec.iso: https://sagedebianlive.metelu.net/plopkexec.iso .. _gparted: http://gparted.org/ .. _replicating: Further installs (replicating the key) -------------------------------------- - Boot from the installed USB key. - Plug another USB key on the computer. - Click on the "clone the key" icon: the installed key will replicate itself to the new plugged one (except from personal data). WARNING: all data on the target USB key will be lost. If you want to keep your personal data, select the "upgrade the key" option, this option will be proposed if it is possible (e.g. enough free space for upgrading). This key-to-key cloning process allows you to spread the sage debian USB key in time O(log(n)) in a room of n participants with laptops !