## Files - Defining installation components |
previous | up | next

On this tab of the Files steps you can optionally define installation components.

| Installation components can be used to allow the user to customize the installation. GUI installers will present a step that lists all available installation components as checkboxes and lets the user choose which components to install. If no installation components are defined, that step will be omitted and the entire distribution tree is installed. The list on the left displays installation components in the order in which they will be displayed to the user. The right pane displays the distribution tree and allows you to select the files and directories that belong to the installation component.

| The control buttons allow you to modify the contents of the list of installation components: Add installation component (key `INS`) Shows an input dialog where you can enter a name for the installation component. If you have to internationalize the name of the component for different media files, please use a user variable. Remove installation component (key `DEL`) Removes the currently selected installation component after a confirmation dialog. Also available from the context menu. Move installation component up (key `ALT-UP`) Moves the selected installation component up one position in the list. Also available from the context menu. Move installation component down (key `ALT-DOWN`) Moves the selected installation component down one position in the list. Also available from the context menu. To rename an installation component, choose Rename from the context menu.

| To choose the contents of an installation component, you first have to decide whether the component contains all files or just a selection of files or directories. For a selection of files and directories, you then choose the desired contents in the tree. Installation components are not mutually exclusive and you can include the same files in multiple installation components. There are no dependencies between installation components and every component must include all the files it needs for proper functioning. However, it is possible to define mandatory components that cannot be deselected by the user. The first installation component is mandatory by default. To change which components should be mandatory, see the "installation components" screen on the Installer features tab of the installer step. In that step, it is also possible to define which installation components should be selected by default.