1  [[cha:starting-linuxcnc]]
 2  
 3  = Starting LinuxCNC
 4  
 5  == Running LinuxCNC
 6  
 7  LinuxCNC is started with the script file 'linuxcnc'.
 8  
 9  ----
10  linuxcnc [options] [<ini-file>]
11  ----
12  
13  .linuxcnc script options
14  * '-v' = verbose - prints info as it works
15  * '-d' = echoes script commands to screen for debugging
16  
17  If the linuxcnc script is passed an ini file it reads the ini file and starts
18  LinuxCNC. The ini file [HAL] section specifies the order of loading up HAL
19  files if more than one is used. Once the HAL=xxx.hal files are loaded then the
20  GUI is loaded then the POSTGUI=.xxx.hal file is loaded. If you create PyVCP or
21  GladeVCP objects with HAL pins you must use the postgui HAL file to make any
22  connections to those pins. See the <<sec:hal-section,[HAL]>> section of the
23  INI configuration for more information.
24  
25  [[sub:configuration-selector]]
26  
27  === Configuration Selector
28  
29  If no ini file is passed to the linuxcnc script it loads the configuration 
30  selector so you can choose and save a sample configuration. Once a sample
31  configuration has been saved it can be modified to suit your application.
32  The configuration files are saved in linuxcnc/configs directory.
33  
34  .Configuration Selector
35  
36  image::images/configuration-selector.png[align="center", alt="LinuxCNC Configuration Selector"]