Unified Installation Creator uic is a toolkit build on top of debootstrap that allows to automate the creation of customized command line Linux installations based on Debian-Derived distributions. It is able to create life distributions as well as install a customized distribution on a target system. It is mainly intended as a toolkit for system administrators who have often to install Linux servers with particular, repeating characteristics.

uic_get - manpage



uic_get - prepares an installation environment based on the specified template


uic_get [−hveF] [−n <name>] <template source> [<destination path>]

uic_get [−v] −s <template name>

uic_get [−v] −l [<search regex>]


uic_get initialises an installation environment based on a uic template source. Template sources are distributed as compressed tar archives. uic_get retrieves the specified template, unpacks it into the default or the specified <destination path> and checks it for integrity. The <template source> can be a physical path to a locally reachable template file, an http or ftp url to a template file or simply the base name of a template. In that case uic_get will search the configured uic repositories for the latest version of the desired template. If <destination path> is not specified, the default working path (usually /usr/src) will be used.

uic_get can also be used to inspect the repository (see below).


−h, −−help

shows the help for the command.

−v, −−verbose

increases the verbosity level of the command. If specified more than once, the verbosity level will be increased.

−l, −−list

outputs a list of templates available in the configured repositories. The list can be filtered through a specified regular expression

−s, −−show

shows all available versions of the specified template name in the configured repositories.

−n <name>, −−name <name>

use an alternative name instead of the original name for the installation environment. When used for creating a derived template, the name should be changed manually also in the template configuration file uictp.conf.

−e, −−enter

change directory into the installation environment after retrieval and initialisation

−F, −−force

force deletion of existing installation environment. Since uic_get will not overwrite by default existing installation environments found in the destination directory, this option permits to execute the command also if there is already an installation environment in place.


uic get /home/leo/netpoldo-1404-32_10.04.04-39.tar.bz2

prepares an installation environment from the template /home/leo/netpoldo-1404-32_10.04.04-39.tar.bz2 The resulting template will be stored in /home/leo/uic-projects using the default template name (resulting in /home/leo/uic-projects/netpoldo-1404-32 ).

uic get netpoldo-1404-32

searches the uic template repository for the latest version of netpoldo-1404-32. If found, the template will be downloaded and an installation environment will be created in the default working directory (/usr/src) using the default template name (resulting in /usr/src/netpoldo-1404-32).

uic get alix-rescue_10.04.04-12.tar.bz2 −vF −n alix-router .

prepares an installation environment from the template alix-rescue_10.04.04-12.tar.bz2 located in the current directory. The resulting template will be stored also in the current directory using the specified template name (resulting in ./alix-router). The command will produce verbose output and will succeed also if ./alix-router is already existing.

uic get −l

Lists all templates available on the configured repositories.

uic get −l alix.*

Lists all templates which name starts with alix on the configured repositories.

uic get −s alix-rescue-0804

Lists all versions stored on the repositores of the template alix-rescue-0804.



uic configuration file. See uic.conf (8)


template definition and configuration file. See uic.files (7)


template hook scripts directory See uic.hooks (7)


directory of files to add to the installation. See uic.files (7)


list of files to remove from the installation. See uic.files (7)


directory of additional files used during the build steps. See uic.files (7)


uic was written by Leo Moll <leo.moll@yeasoft.com>


uic(7), uic_attach(7). uic_build(7), uic_clean(7), uic_create(7), uic_detach(7). uic_enter(7), uic_install(7), uic_pack(7), uic_purge(7), uic_upgrade(7), uic.files(7), uic.hooks(7), uic.conf(7)

This page was last updated on May 16, 2014, 16:54:17