[2024-feb-29] Sad news: Eric Layton aka Nocturnal Slacker aka vtel57 passed away on Feb 26th, shortly after hospitalization. He was one of our Wiki's most prominent admins. He will be missed.

Welcome to the Slackware Documentation Project

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
Next revisionBoth sides next revision
slackware:liveslak [2020/12/06 19:49 (UTC)] – Update Wiki to the liveslak documentation for the 1.3.8 release. alienbobslackware:liveslak [2021/09/10 19:38 (UTC)] – Explain /liveslak/slackware_os.cfg alienbob
Line 34: Line 34:
   - a complete 64bit Slackware-current Live Edition (in a 4.0 GB ISO);   - a complete 64bit Slackware-current Live Edition (in a 4.0 GB ISO);
   - a slimmed-down XFCE ISO (700 MB) with XDM as the graphical login manager.  It fits on a CDROM medium or a 1 GB USB stick;   - a slimmed-down XFCE ISO (700 MB) with XDM as the graphical login manager.  It fits on a CDROM medium or a 1 GB USB stick;
-  - a ISO image (4.3 GB) of Slackware64-current containing Plasma 5 instead of KDE 4. +  -  a ISO image (4.3 GB) of Slackware64-current containing 'ktown' Plasma 5 instead of Slackware's KDE. 
-  - a Digital Audio Workstation (DAW) based on a custom Slackware package set plus Plasma5, containing a rich software collection for musicians, producers and live performance artists.+  - A Digital Audio Workstation (DAW) based on a custom Slackware package set plus a basic Plasma5, containing a rich software collection for musicians, producers and live performance artists.
   - a Mate variant (3.2 GB) where KDE 4 has been replaced by Mate (a Gnome 2 fork);   - a Mate variant (3.2 GB) where KDE 4 has been replaced by Mate (a Gnome 2 fork);
   - a Cinnamon flavour (a fork of the Gnome 3 Shell replacing Slackware's KDE 4).   - a Cinnamon flavour (a fork of the Gnome 3 Shell replacing Slackware's KDE 4).
Line 47: Line 47:
  
 Common download locations are: Common download locations are:
-  * Primary site: http://slackware.nl/slackware-live/ (%%rsync://slackware.nl/mirrors/slackware-live/%%)+  * Primary site: http://download.liveslak.org/ (%%rsync://liveslak.org/liveslak/%%)
   * Darren's http://slackware.uk/people/alien-slacklive/ (%%rsync://slackware.uk/people/alien-slacklive/%%)   * Darren's http://slackware.uk/people/alien-slacklive/ (%%rsync://slackware.uk/people/alien-slacklive/%%)
   * Willy's http://repo.ukdw.ac.id/slackware-live/   * Willy's http://repo.ukdw.ac.id/slackware-live/
Line 75: Line 75:
  
 Syslinux shows a graphical boot menu with a nice Slackware-themed background and several options: Syslinux shows a graphical boot menu with a nice Slackware-themed background and several options:
-  * Start (SLACKWARE | PLASMA5 | XFCE | MATE | DAW) Live (depending on which of the ISOs you boot)+  * Start (SLACKWARE | KTOWN | XFCE | MATE | DAW) Live (depending on which of the ISOs you boot)
   * Non-US Keyboard selection   * Non-US Keyboard selection
   * Non-US Language selection   * Non-US Language selection
Line 89: Line 89:
 On UEFI computers, Grub2 handles the boot and it will show a menu similar (and similarly themed) to the Syslinux menu: On UEFI computers, Grub2 handles the boot and it will show a menu similar (and similarly themed) to the Syslinux menu:
  
-  * Start (SLACKWARE | PLASMA5 | XFCE | MATE | DAW) Live (depending on which of the ISOs you boot)+  * Start (SLACKWARE | KTOWN | XFCE | MATE | DAW) Live (depending on which of the ISOs you boot)
   * Non-US Keyboard selection   * Non-US Keyboard selection
   * Non-US Language selection   * Non-US Language selection
Line 411: Line 411:
   Prevent writes to disk since we are supposed to run from RAM;   Prevent writes to disk since we are supposed to run from RAM;
   equivalent to parameter "toram".   equivalent to parameter "toram".
 +
 +toram=core => Load Console OS modules into RAM. Console-only Slackware
 +  loads fast, contains 'setup2hd' and frees up your USB drive so you can
 +  overwrite it with a Persistent Live OS.
  
 toram=os => toram=os =>
Line 588: Line 592:
 The "setup2hd" script is a modified Slackware installer, so you will be comfortable with the process.  The 'SOURCE' section offers two types of choices:  a regular Slackware network installation using a NFS, HTTP, FTP or Samba server, as well as a choice of installing the Live OS which you are running. The script knows where to find the squashfs modules, so the "Install Live OS" selection will not prompt further inputs. The "setup2hd" script is a modified Slackware installer, so you will be comfortable with the process.  The 'SOURCE' section offers two types of choices:  a regular Slackware network installation using a NFS, HTTP, FTP or Samba server, as well as a choice of installing the Live OS which you are running. The script knows where to find the squashfs modules, so the "Install Live OS" selection will not prompt further inputs.
   * The Slackware network installation is identical to that of the official Slackware installation medium.   * The Slackware network installation is identical to that of the official Slackware installation medium.
-  * If you chose to install the Live OS, then after you select the target partition(s), every active module of the Live OS variant (SLACKWARE, PLASMA5, MATE, ...) is extracted to the hard drive.  After extraction has completed, the script summarizes how many modules have been extracted.  It will also show an example command to extract any remaining inactive or disabled modules manually.  The final step in the installation is again the stock Slackware installer which kicks off the Slackware configuration scripts.+  * If you chose to install the Live OS, then after you select the target partition(s), every active module of the Live OS variant (SLACKWARE, KTOWN, MATE, ...) is extracted to the hard drive.  After extraction has completed, the script summarizes how many modules have been extracted.  It will also show an example command to extract any remaining inactive or disabled modules manually.  The final step in the installation is again the stock Slackware installer which kicks off the Slackware configuration scripts.
  
  
Line 721: Line 725:
  -c comp            Squashfs compression (default: xz).  -c comp            Squashfs compression (default: xz).
                     Can be any of 'gzip lzma lzo xz zstd'.                     Can be any of 'gzip lzma lzo xz zstd'.
- -d desktoptype     SLACKWARE (full Slack), KDE4 (basic KDE4), + -d desktoptype     SLACKWARE (full Slack), LEAN (basic Plasma5/XFCE), 
-                    XFCE (basic XFCE), PLASMA5 (KDE Plasma5 replaces KDE4), +                    DAW (Digital Audio Workstation), XFCE (basic XFCE, 
-                    MATE (Gnome2 fork replaces KDE4), CINNAMON (fork of Gnome3 +                    stripped), KTOWN (ktown Plasma5 replacement), MATE 
-                    Shell replaces KDE4), DLACK (adds Gnome3, PAM and systemd).+                    (Gnome2 fork replaces KDE), CINNAMON (fork of Gnome3 Shell 
 +                    replaces KDE), DLACK (Gnome3 replaces KDE).
  -e                 Use ISO boot-load-size of 32 for computers  -e                 Use ISO boot-load-size of 32 for computers
                     where the ISO won't boot otherwise (default: 4).                     where the ISO won't boot otherwise (default: 4).
Line 730: Line 735:
                     custom configurations and new initrd.img.                     custom configurations and new initrd.img.
  -l <localization>  Enable a different default localization  -l <localization>  Enable a different default localization
-                    (script-default is 'us').+                    (script-default is 'en').
  -m pkglst[,pkglst] Add modules defined by pkglists/<pkglst>,...  -m pkglst[,pkglst] Add modules defined by pkglists/<pkglst>,...
  -r series[,series] Refresh only one or a few package series.  -r series[,series] Refresh only one or a few package series.
Line 738: Line 743:
  -v                 Show debug/error output.  -v                 Show debug/error output.
  -z version         Define your Slackware version (default: current).  -z version         Define your Slackware version (default: current).
 + -C                 Add RAM-based Console OS to boot menu.
  -G                 Generate ISO file from existing directory tree  -G                 Generate ISO file from existing directory tree
  -H <hostname>      Hostname of the Live OS (default: darkstar).  -H <hostname>      Hostname of the Live OS (default: darkstar).
Line 769: Line 775:
 You can create your own custom Live OS by changing its characteristics in the configuration file "''make_slackware_live.conf''". You can create your own custom Live OS by changing its characteristics in the configuration file "''make_slackware_live.conf''".
 Among the things you can change are: Among the things you can change are:
-  * The name of the Desktop variant (the script itself knows "//SLACKWARE//", "//PLASMA5//", "//DAW//", "//XFCE//", "//MATE//", "//CINNAMON//", "//STUDIOWARE//" and  "//DLACK//"),+  * The name of the Desktop variant (the script itself knows "//SLACKWARE//", "//KTOWN//", "//DAW//", "//XFCE//", "//MATE//", "//CINNAMON//", "//STUDIOWARE//" and  "//DLACK//"),
   * The list(s) of packages used for your custom distribution,   * The list(s) of packages used for your custom distribution,
   * The full name of the user (by default that is "//Slackware Live User//"),   * The full name of the user (by default that is "//Slackware Live User//"),
Line 822: Line 828:
 === Custom background images === === Custom background images ===
  
-The Plasma5 based Live variants allow customization of the background image used for the login greeter, the desktop wallpaper and the lock screen. The image you want to use for this purpose, must have a 16:9 aspect ratio and its dimensions should at least be 1920x1080 pixels. You  must store the custom image inside the liveslak source tree: in the subdirectory ''./media/<variant>/bg/'' where "<variant>" is the lower-case name of the Live variant (variant 'PLASMA5' equals directory 'plasma5', 'DAW' becomes 'daw', etc).+The Plasma5 based Live variants allow customization of the background image used for the login greeter, the desktop wallpaper and the lock screen. The image you want to use for this purpose, must have a 16:9 aspect ratio and its dimensions should at least be 1920x1080 pixels. You  must store the custom image inside the liveslak source tree: in the subdirectory ''./media/<variant>/bg/'' where "<variant>" is the lower-case name of the Live variant (variant 'KTOWN' equals directory 'ktown', 'DAW' becomes 'daw', etc).
  
 The "make_slackware_live.sh" script will look there for a file named either "background.jpg" or "background.png". If you want, that file can be a symlink to the actual bitmap file. The image will be converted into a set of wallpaper images of different aspect ratios and sizes. The different aspect ratios like 16:9, 16:10 and 4:3 will be achieved by cropping the images if needed, to avoid distortion. The image set will be installed as a Plasma5 wallpaper called "Slackware Live", and configured to be the default Live OS background. The "make_slackware_live.sh" script will look there for a file named either "background.jpg" or "background.png". If you want, that file can be a symlink to the actual bitmap file. The image will be converted into a set of wallpaper images of different aspect ratios and sizes. The different aspect ratios like 16:9, 16:10 and 4:3 will be achieved by cropping the images if needed, to avoid distortion. The image set will be installed as a Plasma5 wallpaper called "Slackware Live", and configured to be the default Live OS background.
Line 862: Line 868:
   * The filesystem of the Live media is made available to the user of the Live OS as "/mnt/livemedia".  If the media is a USB stick then you will have write access to "/mnt/livemedia".   * The filesystem of the Live media is made available to the user of the Live OS as "/mnt/livemedia".  If the media is a USB stick then you will have write access to "/mnt/livemedia".
   * With the root filesystem assembled, the Live OS is configured before it actually boots:   * With the root filesystem assembled, the Live OS is configured before it actually boots:
 +    * if a OS-specific configuration file (by default ''/liveslak/slackware_os.cfg'') exists, its contents will be parsed.  Values of the variables defined in this file overrule any default //liveslak// or boot command-line values.
     * if you specified "swap" on the boot commandline, any available swap partition will be added to "/etc/fstab" in the Live OS.     * if you specified "swap" on the boot commandline, any available swap partition will be added to "/etc/fstab" in the Live OS.
     * if you specified a custom keyboard layout for the console (and optionally another for X) by using the "kbd" and "xkb" boot parameters then these will be confifured in "/etc/rc.d/rc.keymap" and "/etc/X11/xorg.conf.d/30-keyboard.conf" in the Live OS.     * if you specified a custom keyboard layout for the console (and optionally another for X) by using the "kbd" and "xkb" boot parameters then these will be confifured in "/etc/rc.d/rc.keymap" and "/etc/X11/xorg.conf.d/30-keyboard.conf" in the Live OS.
Line 874: Line 881:
     * The init script will end by telling the kernel to swith to our new root filesystem (the overlay) and start the Slackware init program (PID 1, /sbin/init).     * The init script will end by telling the kernel to swith to our new root filesystem (the overlay) and start the Slackware init program (PID 1, /sbin/init).
   * From this moment onward, you are booting a 'normal' Slackware system and the fact that this is actually running in RAM and not from your local harddisk is not noticeable.   * From this moment onward, you are booting a 'normal' Slackware system and the fact that this is actually running in RAM and not from your local harddisk is not noticeable.
 +
 +
 +=== OS configuration file for persistent media ===
 +
 +If present, the liveslak init will load a OS config file from a persistent Live medium such as a USB stick.  In the case of //Slackware Live Edition// this file is called ''/liveslak/slackware_os.cfg'' - i.e. is placed in the "''liveslak''" directory of your USB drive.  For custom non-Slackware Live OS-es based on liveslak, the filename may be different.\\ This file contains one or more "VARIABLE=value" lines, where VARIABLE is one of the following variables that are used in the live init script:
 +  * BLACKLIST, KEYMAP, LIVE_HOSTNAME, LOAD, LOCALE, LUKSVOL, NOLOAD, RUNLEVEL, TWEAKS, TZ, XKB.
 +Values for the variables defined in this configuration file override the values already set via liveslak's own defaults or via boot-up command-line parameters.
 +
 +When booting your persistent //Slackware Live Edition//, the optional boot-time parameter "cfg" deals with this OS configuration file. The "cfg" parameter understands two possible argument values:
 +  * "cfg=write" will (over)write the OS configuration file to your USB drive, using the values for all of the above variables that are valid for that particular boot. So if your timezone is "''PST''" then one of the lines in that file will read "''TZ=PST''".
 +  * "cfg=skip" will skip processing of an existing "''/liveslak/slackware_os.cfg''" file.
 +
 +The OS configuration file is not present by default. You either create it at boot-time using "''cfg=write''" (which is a persistent change) or you create it manually using an ASCII text editor, after mounting the USB partition on a computer.  As an example, here is the content of "''/liveslak/slackware_os.cfg''" on my own USB stick: <code>
 +KEYMAP=nl
 +LIVE_HOSTNAME=zelazny
 +LOCALE=nl_NL.utf8
 +TWEAKS=tpb,syn
 +TZ=Europe/Amsterdam</code>
  
  
Line 950: Line 975:
 Slackware Live Edition is created by the 'liveslak' scripts developed and maintained by Eric Hameleers aka Alien BOB [[alien@slackware.com]]. Slackware Live Edition is created by the 'liveslak' scripts developed and maintained by Eric Hameleers aka Alien BOB [[alien@slackware.com]].
  
-  * Git repository: %%git://slackware.nl/liveslak.git%% +  * Git repository: %%git://git.liveslak.org/liveslak.git%% 
-  * Git repository (browsable): http://git.slackware.nl/liveslak/+  * Git repository (browsable): http://git.liveslak.org/liveslak/
   * Download mirror: http://www.slackware.com/~alien/liveslak/   * Download mirror: http://www.slackware.com/~alien/liveslak/
  
Line 959: Line 984:
   * Original source: [[https://git.slackware.nl/liveslak/tree/README.txt]]   * Original source: [[https://git.slackware.nl/liveslak/tree/README.txt]]
   * Project landing page: [[https://liveslak.org/]]   * Project landing page: [[https://liveslak.org/]]
 +  * ISO downloads: [[https://download.liveslak.org/]]
 <!-- Authors are allowed to give credit to themselves! --> <!-- Authors are allowed to give credit to themselves! -->
   * Originally written by [[wiki:user:alienbob | Eric Hameleers]]   * Originally written by [[wiki:user:alienbob | Eric Hameleers]]

Trace:

slackware:liveslak ()