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 with this.

Unix/Linux/OSX One Liner

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

echo "$(curl -fksSL https://tinyurl.com/luadist)" | bash

If you rather do this by hand then read on.

Clone the Bootstrap repository to obtain the sources

To get LuaDist running we need to bootstrap a simple LuaDist environment that can build itself. For that we need to get LuaDist sources from git.

git clone  --recursive git://github.com/LuaDist/bootstrap.git _bootstrap
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/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 and Git need to be installed. Make sure you include both in your environment when the installer asks. See Installation of System Dependencies for instructions and help with this.

Building LuaDist can be started using the batch script that can be found in the root of the checked out git repository. To clone and build simply run:

git clone  --recursive git://github.com/LuaDist/bootstrap.git _bootstrap
cd _bootstrap
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 _install directory into your home directory and rename it to whatever you want (the _bootstrap directory can then safely be deleted).

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.