Configuration
LuaDist is configured using a Lua configuration file which is available in share/lua/lmod/dist/config.lua. This file is automatically generated when LuaDist is built and does not require changes in most cases. However if you would like to change how LuaDist behaves to better fit your need you can edit the following options.
Behaviour
Following variables in the configuration file affect the behavior of LuaDist.
- binary - true by default. Allows the use of binary dists. This should be disabled in source only distribution. Enabled in binary distribution.
- source - true by default. Allows the use of souce dists. This will allow LuaDist to build modules from source, requires a C compiler and CMake to be installed. Source and binary dists can be enabled at the same time, binary packages take precedence.
- link - true by default. This option will enable the use of symlinks in the deployment process. For Windows and Cygwin this has to be disabled as symlinks are not supported on the Windows platform.
- start - true by default. LuaDist will generate a batch file in the deployment directories that is used to setup environment variables for LuaDist apps. This allows you to run applications using: ./start [app] without setting up anything.
- doc - true by default. Autogenerate documentation index. Currently not implemented.
- test - false by default. Run tests before installing a dist. Currently not implemented.
- debug - false by default. Enabling debug mode will increase verbosity of LuaDist for easier debugging. When building source dists with debugging enabled, LuaDist will allow you to review each dist configuration befor building using cmake-gui.
- proxy - false by default. If you need to use proxy type its address here as string.
- timeout - 10 by default. Timeout for HTTP fetch function, in seconds.
Repositories
LuaDist can use local and remote directories as source of dists. Searching is sequential so repositories mentioned first have higher priority than later entries.
- repo - List of URLs containing dists. Eg. "file://home/joe/dists", "http://myserver.tld/repo", "file://C:/Dists" etc.