10. Installation

There is a script Installer.ksh in NsCDE top level directory when unpacked. When run without any arguments, installer script will print usage with explanations and examples. Installing NsCDE is relatively simple: if some mandatory dependency is missing (for example FVWM or ksh), installer will print that error, as well for some Python3 modules. For optional dependencies, that is, programs and components which are not essential it will just print a warning.

The main moduses of installation are:


  $ su - || sudo -i
  # umask 0022
  # cd /tmp
  # wget https://github.com/NsCDE/NsCDE/archive/NsCDE-<version>.tar.gz
  # tar xpzf NsCDE-<version>.tar.gz
  # cd NsCDE-<version>
  # ./Installer -w -n -i

For FVWM3 or FVWM2 patched with NsCDE patches from NsCDE-<version>/src one can use "-f" mode of installation instead "-w".


  $ su - || sudo -i
  # umask 0022
  # cd /tmp
  # wget https://github.com/NsCDE/NsCDE/archive/NsCDE-<version>.tar.gz
  # tar xpzf NsCDE-<version>.tar.gz
  # cd NsCDE-<version>
  # ./Installer -f -n -i

Both of the examples above will install NsCDE into /opt/NsCDE. However, it is possible to install to some other place. For example, this will install NsCDE in /data/programs/nscde:


  # ./Installer -p /data/programs/nscde -f -n -i

For interactive mode of installation "-n" must be ommited. An asking wizard type of installation will appear.

For a latest master tree from development page on Github, NsCDE can be fetched with git(1) and upgraded with fetching changes in the master or some other branch. An example of this would be:


  # git clone https://github.com/NsCDE/NsCDE.git
  # cd NsCDE
  # ./Installer.ksh -w -n -i

Upgrades, either from tarball or from git, once new version is downloaded can be made by replacing "-i" option with "-u" option for the installer. Example of upgrade:


  # git clone https://github.com/NsCDE/NsCDE.git
  # cd NsCDE
  # ./Installer.ksh -w -n -u (or ./Installer.ksh -f -n -u)

Similarly, option "-d" is for uninstallation etc ... run Installer.ksh without arguments for a full set of options.