LuaDist: Installation

Prerequisites

Luadist requires the presence of C compiler, Git and CMake on the system. See Installation of System Dependencies for instructions and help.

Obtaining LuaDist

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

Unix/Linux/OSX One Liner including batteries package

For the lazy. Takes a while .. you can get a coffee. Oh, and you need XCode/Build Tools and CMake.

echo "$(curl -fksSL https://raw.github.com/gist/2394281/luadist.sh)" | bash

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
cd bootstrap
git submodule update --init

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/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. See Installation of System Dependencies for instructions and help.

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.