LuaDist: Installation

Obtaining LuaDist

Stable releases (source and binary) of LuaDist can be downloaded from the Downloads section of the Repository.

Clone the Bootstrap repository (optional)

If you are feeling adventurous you can also try using the development repository of the install process instead of using downloaded sources.

> git clone git://github.com/LuaDist/bootstrap.git
> git submodule update --init
> cd bootstrap

Building on Unix, OSX, Linux, Cygwin ...

On most Unix based systems a C compiler, make and CMake 2.8.4+ need to be installed. For Debian based Linux distribution this means to install gcc, make and cmake packages.

Building LuaDist is simple using the provided build script. Simply extract the sources and run:

> ./bootstrap

Once LuaDist is built it will be installed into _install subdirectory. To test the result we try to build a new deployment on the Desktop.

> cd _install/luadist-*/bin
> ./luadist ~/Desktop/my_lua install lua luasocket md5
> cd ~/Desktop/my_lua/bin
> ./lua -e "require 'socket'"

LuaDist deployment directories are self contained and can be moved around without the need to install components into the host operating system. To install LuaDist simply copy the directory into your home directory.

Building on Windows MinGW (Recommended)

For building LuaDist on systems running Windows we recommend using the MinGW compiler. However most users will find it easier to install MinGW using a installer available from TDM. Next, CMake needs to be installed. Make sure you include it in our environment when the installer asks.

Building LuaDist can now be started using the build.bat script. Simply extract sources and run:

> cd unpacked\luadist
> bootstrap.bat

Once LuaDist is built it will be installed into _install subdirectory. To test the result we try to build a new deployment.

> cd _install\bin
> luadist C:\my_lua install lua luasocket md5
> cd C:\my_lua\bin
> lua -e "require 'md5'"

LuaDist deployment directories are self contained and can be moved around without the need to install components into the host operating system. To install LuaDist simply copy the directory into your home directory.

What Now ?

For advanced use please see LuaDist: Configuration and LuaDist: Use. To install most commonly used modules you can try installing the batteries meta-package:

> cd _install\bin
> luadist C:\batteries install batteries
> cd C:\batteries\bin
> wxlua

Manual Installation (without the luadist tool)

Please see LuaDist:-Manual-Installation.

Uninstall

Simply delete the deployment directory LuaDist is installed in. There are no components installed into the host operating system nor are any settings stored in the registry or /etc folder.