Multiple Lazarus: what changed
Revision 2 to 3. Removed lines have a minus sign; added lines have a plus sign.
| Old | New | Line | |
|---|---|---|---|
| 1 | 1 | ## Multiple Lazarus instances | |
| 2 | 2 | ||
| 3 | - | ||
| 4 | - | ||
| 3 | + | You can have one directory with Lazarus in it on your system or more. These directories can contain the same or different versions of Lazarus and can be made to work independent of each other (see the section dealing with **\--primary-config-dir** below). Because you don't have to install Lazarus and the versions may be the same, the concept of having more than one Lazarus directory on your system will be called "multiple instances" in this article. | |
| 4 | + | Runthrough for Linux at [[DualLaz]]. | |
| 5 | 5 | ||
| 6 | 6 | ## Important | |
| 7 | 7 | ||
| 8 | - | ||
| 9 | - | ||
| 10 | - | ||
| 8 | + | * Make Backups of | |
| 9 | + | * Your primary config (e.g. ~/.lazarus under Unix) | |
| 10 | + | * Your projects *.lpi and *.lps | |
| 11 | 11 | ||
| 12 | 12 | ## Who needs multiple Lazarus instances and who does not? | |
| 13 | 13 | ||
| 14 | - | ||
| 14 | + | You need multiple Lazarus instances... | |
| 15 | 15 | ||
| 16 | - | ||
| 17 | - | ||
| 16 | + | * to have several versions of Lazarus | |
| 17 | + | * to have one Lazarus version compiled with several different versions of [[FPC]] | |
| 18 | 18 | ||
| 19 | - | ||
| 19 | + | You don't need multiple instances... | |
| 20 | 20 | ||
| 21 | - | ||
| 22 | - | ||
| 21 | + | * to test your project with different [[Widgetset|widgetsets]] | |
| 22 | + | * to [[Cross compiling|cross compile]] | |
| 23 | 23 | ||
| 24 | 24 | ## The Lazarus directory | |
| 25 | 25 | ||
| 26 | - | ||
| 26 | + | The Lazarus directory (i.e. the directory where the Lazarus application is) is overridable using --lazarusdir, this is useful when running Lazarus from e.g. USB sticks with varying mountpoints or driveletters. | |
| 27 | 27 | ||
| 28 | 28 | ## The config directory | |
| 29 | 29 | ||
| 30 | - | ||
| 31 | - | ||
| 32 | - | ||
| 30 | + | All IDE options for an instance are saved to a config directory. Under Linux, macOS and BSD the default config directory is ~/.lazarus. Note the beginning dot, which makes it a hidden directory. | |
| 33 | 31 | ||
| 34 | - | ||
| 32 | + | On Windows, settings are saved to the User AppData folder, which maps to a different directory depending on the Windows version (and language, in Windows XP and earlier). See also information here: Windows. Note that you won't see the configuration directory in Windows unless you select to see hidden and system files. To view the directory, type: | |
| 33 | + | ``` | |
| 35 | 34 | %localappdata% | |
| 36 | 35 | ``` | |
| 37 | 36 | ||
| 38 | - | ||
| 39 | - | ||
| 40 | - | ||
| 41 | - | ||
| 42 | - | ||
| 43 | - | ||
| 44 | - | ||
| 37 | + | in the Start/Run box or in the address bar of Windows Explorer, which should bring you to the Local Application Data directory. For default installs, the settings are stored in the Lazarus directory shown there. | |
| 45 | 38 | ||
| 46 | - | ||
| 39 | + | Operating System | Default location for the config directory | Remarks | |
| 40 | + | ---|---|--- | |
| 41 | + | Linux, macOS, BSD, other UNIXes | ~/.lazarus | Hidden directory | |
| 42 | + | Windows XP | C:\Documents and Settings\<User name>\Local Settings\Application Data\lazarus | English Windows; others may have different paths | |
| 43 | + | Windows Vista and higher | C:\Users\<User name>\AppData\Local\lazarus\ | Regardless of selected language | |
| 44 | + | ||
| 45 | + | The config directory can **not** be shared between different Lazarus versions. A newer Lazarus can read older configs and will update them automatically. There is no guarantee that an older version can read config files of a newer version. It is always a good idea to make a backup of your configs from time to time for time you might’ve change something weird and not know what it was. | |
| 47 | 46 | ||
| 48 | 47 | ### Solution for separating instances using multiple config dirs | |
| 49 | 48 | ||
| 50 | - | ||
| 51 | - | ||
| 52 | - | ||
| 49 | + | The config directory can be given on the command line with the --primary-config-path parameter (shorter version: --pcp). For example: | |
| 50 | + | ``` | |
| 53 | 51 | lazarus --primary-config-path=~/.lazarus2 | |
| 54 | 52 | ``` | |
| 55 | 53 | ||
| 56 | - | ||
| 57 | - | ||
| 58 | - | ||
| 54 | + | will start an IDE using _~/.lazarus2_ as config directory. This way you can have an arbitrary number of config directories and start several independent Lazarus instances. As Lazarus creates the settings files from default if they don't exist, you can specify empty directories if you want. | |
| 59 | 55 | ||
| 60 | - | ||
| 56 | + | If you use this often, then a small shell script can be created: | |
| 57 | + | ``` | |
| 61 | 58 | #!/bin/sh | |
| 62 | - | ||
| 59 | + | /path/to/lazarus --primary-config-path=~/.lazarus2 | |
| 63 | 60 | ``` | |
| 64 | 61 | ||
| 65 | - | ||
| 66 | - | ||
| 67 | - | ||
| 62 | + | In Windows you cannot use ~ so use instead, for example, a shortcut on the desktop with the following parameters to call Lazarus: | |
| 63 | + | ``` | |
| 68 | 64 | \path\to\lazarus.exe --primary-config-path=lazarusconf | |
| 69 | 65 | ``` | |
| 70 | 66 | ||
| 71 | - | ||
| 67 | + | This will place the lazarus configuration directory inside the lazarus directory. | |
| 72 | 68 | ||
| 73 | 69 | ### Using lazarus.cfg file | |
| 74 | 70 | ||
| 75 | - | ||
| 71 | + | Another way for setting config directory is using a `lazarus.cfg` file and putting it into the folder with the Lazarus executable and putting this line into it: | |
| 72 | + | ``` | |
| 73 | + | --primary-config-path=<path> | |
| 74 | + | ``` | |
| 76 | 75 | ||
| 77 | - | ||
| 78 | - | ||
| 76 | + | or | |
| 79 | 77 | ``` | |
| 78 | + | --pcp=<path> | |
| 79 | + | ``` | |
| 80 | 80 | ||
| 81 | - | ||
| 81 | + | Do not add quotes to the entire line (`"--pcp=path"`) or to the parameter value (`--pcp="path"`) - all content is read to the end of the line, even if it contains spaces. Quotation marks can be read as part of the path, which will lead to errors. | |
| 82 | 82 | ||
| 83 | - | ||
| 83 | + | You can make a config folder any where you like and set it's path to the `lazarus.cfg` file. After that Lazarus will use this file and there is no need to make a shell script or use shortcut file with the `--pcp` parameter. | |
| 84 | 84 | ||
| 85 | - | ||
| 85 | + | For example, for a Windows installation it will be like this: a config folder and a `lazarus.cfg` file near the Lazarus executable and put a value like this for example into the cfg file: | |
| 86 | + | ``` | |
| 86 | 87 | --primary-config-path=C:\Lazarus2\config\ | |
| 87 | 88 | ``` | |
| 88 | 89 | ||
| 89 | - | ||
| 90 | + | And run Lazarus. It will ask for some config values and after that you can make a simple shortcut for later use without any parameters. | |
| 90 | 91 | ||
| 91 | 92 | ### Config directory files | |
| 92 | 93 | ||
| 93 | - | ||
| 94 | + | See the [[pcp|Primary Config Path]] page. | |
| 94 | 95 | ||
| 95 | - | ||
| 96 | + | _lazarus.dci_ \- stores the Lazarus Code Templates | |
| 96 | 97 | ||
| 97 | - | ||
| 98 | + | _editoroptions.xml_ \- information about colors, fonts and other editor options | |
| 98 | 99 | ||
| 99 | - | ||
| 100 | + | _miscellaneousoptions.xml_ \- packages information | |
| 100 | 101 | ||
| 101 | - | ||
| 102 | + | _environmentoptions.xml_ \- stores the history of opened projects and files (Recent Opened Files and Projects) | |
| 102 | 103 | ||
| 103 | 104 | ## The Lazarus files | |
| 104 | 105 | ||
| 105 | - | ||
| 106 | + | The Lazarus source archive is contained in a single directory. You can simply compile Lazarus (eg, for [[Installing Lazarus on Linux|Linux]] or for [[Installing Lazarus on Windows|Windows]]) and a lot of files and subdirectories will be created, but and all will be below that single subdirectory. | |
| 106 | 107 | ||
| 107 | - | ||
| 108 | + | A Lazarus instance (sources and resources) is a single subdirectory. Just copy this directory and you get a whole new Lazarus instance. | |
| 108 | 109 | ||
| 109 | - | ||
| 110 | + | You don't need to _install_ Lazarus to be able to run it. But if you do indeed _install_ Lazarus, you get some nice shortcuts on your desktop and some file types (e.g. lpk, lpi, pas) are associated with that Lazarus installation. These things are platform dependent. You can have only one formally installed Lazarus but secondary installs work just as well, typically you will start the one you want with a script or cd-ing to its own directory and starting it there. A formal install is typically added to your PATH so care might be needed, when using a secondary copy, that you don't get the 'on path' executable, some users prefer to have no formally installed copies for that reason, Lazarus, built from source works fine from its source directory. | |
| 110 | 111 | ||
| 111 | - | ||
| 112 | + | Newer installers support _installing_ Lazarus multiple times. Alternatively, You can also add another Lazarus instance **manually** quite easily. Of course, file associations etc. can only be linked to one single Lazarus instance. | |
| 112 | 113 | ||
| 113 | 114 | ### Linux | |
| 114 | 115 | ||
| 115 | - | ||
| 116 | + | See the instructions for [[Installing Lazarus on Linux|Installing Lazarus from Source]] and repeat that as many times, each in a new directory, as you like. It often makes sense to use your distro provided version of FPC (as long as its up to date) and build your Lazarus from source. Don't bother to "install" Lazarus, its fine to just have it all in your own file space, cd into the desired directory and launch lazarus from the command line. Just make sure each Lazarus directory has its own config directory (and knows how to find it). | |
| 116 | 117 | ||
| 117 | - | ||
| 118 | + | If you do decide to have one or more Lazarus "installs", its a good idea not to have a package installed version as well. They tend to cause some PATH confusion. | |
| 118 | 119 | ||
| 119 | - | ||
| 120 | + | Find a 2015 run-through for Linux 64 bit at [[DualLaz]]. | |
| 120 | 121 | ||
| 121 | 122 | #### Example 1 : A normally installed Lazarus instance plus the git version | |
| 122 | 123 | ||
| 123 | - | ||
| 124 | - | ||
| 125 | - | ||
| 124 | + | Download and install the Lazarus debian- & .rpm - packages as normal. | |
| 126 | 125 | ||
| 127 | - | ||
| 126 | + | Then download the Lazarus git archive to a directory of your choice, preferably somewhere in your home directory (e.g. ~/lazarus). See here [[Getting Lazarus|Getting Lazarus from the GitLab server]]. | |
| 128 | 127 | ||
| 129 | - | ||
| 128 | + | Start your **secondary** Lazarus with: | |
| 129 | + | ``` | |
| 130 | 130 | /home/you/lazarus/startlazarus --pcp=~/.lazarus2nd | |
| 131 | 131 | ``` | |
| 132 | 132 | ||
| 133 | 133 | #### Example 2 : A normally installed Lazarus instance plus a manual copy | |
| 134 | 134 | ||
| 135 | - | ||
| 136 | - | ||
| 137 | - | ||
| 135 | + | i.e. you obtain two subdirectories: | |
| 136 | + | ``` | |
| 138 | 137 | /usr/lib/lazarus original copy via debian install | |
| 139 | - | ||
| 138 | + | /home/you/lazarus secondary copy | |
| 140 | 139 | ``` | |
| 141 | 140 | ||
| 142 | - | ||
| 143 | - | ||
| 144 | - | ||
| 141 | + | or you may look at: | |
| 142 | + | ``` | |
| 145 | 143 | /home/you/development/lazarus original copy via fpcUP install | |
| 146 | - | ||
| 144 | + | /home/you/lazarus secondary copy | |
| 147 | 145 | ``` | |
| 148 | 146 | ||
| 149 | - | ||
| 150 | - | ||
| 151 | - | ||
| 147 | + | Download and install the Lazarus debian-packages as usual. | |
| 152 | 148 | ||
| 153 | - | ||
| 149 | + | Then copy the Lazarus directory to your home directory and change the ownership of the files: | |
| 150 | + | ``` | |
| 154 | 151 | cp -a /usr/lib/lazarus $(HOME)/ | |
| 155 | - | ||
| 152 | + | chown $USER:$USER -R $(HOME)/lazarus | |
| 156 | 153 | ``` | |
| 157 | 154 | ||
| 158 | - | ||
| 159 | - | ||
| 160 | - | ||
| 155 | + | (Note: The chown line assumes that your group has the same name as your username. If not, replace $USER:$USER with your username:groupname) | |
| 161 | 156 | ||
| 162 | - | ||
| 157 | + | Now change your Lazarus desktop/menu shortcut to start the **secondary** copy | |
| 158 | + | ``` | |
| 163 | 159 | /home/you/lazarus/startlazarus --pcp=~/.lazarus2nd | |
| 164 | 160 | ``` | |
| 165 | 161 | ||
| 166 | - | ||
| 162 | + | Then start the IDE and change the environment options: Tools -> Options -> Environment / Lazarus directory to the **secondary** subdir, namely /home/you/lazarus | |
| 167 | 163 | ||
| 168 | - | ||
| 164 | + | ||
| 165 | + | In recent Lazarus versions, you are also given a screen to name the other important paths, so you would name the secondary sudirs in the 2ndary config. | |
| 169 | 166 | ||
| 170 | - | ||
| 167 | + | Also, inside the /home/you/development/fpc/bin/x86_64-linux/**fpc.cfg** text file, all paths should rather point to your secondary copy. To make sure everything is fine, run **startlazarus** from within xterm and watch the errormessages. make sure all paths are found (very difficult currently). | |
| 171 | 168 | ||
| 172 | - | ||
| 169 | + | ||
| 170 | + | You now have a secondary copy that which you can edit and recompile. Don't forget to close source files of the primary /usr/lib/lazarus. | |
| 173 | 171 | ||
| 174 | 172 | ### Windows | |
| 175 | 173 | ||
| 176 | 174 | #### Example 1: GIT and Release | |
| 177 | 175 | ||
| 178 | - | ||
| 179 | - | ||
| 180 | - | ||
| 176 | + | This is to have both GIT and last release version of Lazarus. | |
| 181 | 177 | ||
| 182 | - | ||
| 178 | + | 1) Install Lazarus last release and check setup option 'create desktop shortcut', you will get 'Lazarus.lnk' on the desktop. | |
| 183 | 179 | ||
| 184 | - | ||
| 180 | + | 2) Get Lazarus from GIT and compile, then create a shortcut on your desktop for 'lazarus.exe' and rename it to 'Lazarus GIT.lnk'. | |
| 185 | 181 | ||
| 186 | - | ||
| 182 | + | Then you can set the config dir for each version editing the shortcut path to the executable: | |
| 187 | 183 | ||
| 188 | - | ||
| 184 | + | This is for release, because you don't change the primary config path parameter, the config will be saved in the default path: | |
| 185 | + | ``` | |
| 189 | 186 | C:\lazarus\startlazarus.exe | |
| 190 | 187 | ``` | |
| 191 | 188 | ||
| 192 | - | ||
| 193 | - | ||
| 194 | - | ||
| 189 | + | For GIT, store the settings e.g. in the folder 'C:\lazgitcfg\': | |
| 190 | + | ``` | |
| 195 | 191 | C:\FPC\laz\startlazarus.exe --primary-config-path=C:\lazgitcfg | |
| 196 | 192 | ``` | |
| 197 | 193 | ||
| 198 | 194 | ## Installation of multiple Lazarus | |
| 199 | 195 | ||
| 200 | 196 | ### Windows - Using the installer | |
| 201 | 197 | ||
| 202 | - | ||
| 198 | + | On Windows the installer (Version 1.1) can create a secondary installation. And it will ask for a folder to store the config. | |
| 203 | 199 | ||
| 204 | - | ||
| 205 | - | ||
| 206 | - | ||
| 207 | - | ||
| 208 | - | ||
| 209 | - | ||
| 210 | - | ||
| 211 | - | ||
| 212 | - | ||
| 213 | - | ||
| 214 | - | ||
| 215 | - | ||
| 216 | - | ||
| 217 | - | ||
| 218 | - | ||
| 219 | - | ||
| 200 | + | * Install: | |
| 201 | + | * Make sure you back up ALL your existing configurations BEFORE you install. | |
| 202 | + | * AGAIN: Make sure you back up ALL your existing configurations BEFORE you install. | |
| 203 | + | * After install check that the correct config is used | |
| 204 | + | See the file "lazarus.cfg" in the installation directory. And Menu "View" > "IDE Internals" > "About IDE" | |
| 205 | + | * If you see a message about upgrading/downgrading the config, then the installation is incorrect. Press "Cancel" | |
| 206 | + | * Usage | |
| 207 | + | * Do not share packages between installations; rather you must have several independent copies of each package | |
| 208 | + | * Backup lpi and lps files (if you share projects). Ideally store sessions (lps) in the "IDE config directory" | |
| 209 | + | Menu: "Project" > "Project Options" > Session | |
| 210 | + | * Uninstall: | |
| 211 | + | * If you plan to uninstall: back up everything again | |
| 212 | + | * Update: | |
| 213 | + | * If you plan to update, back up everything again | |
| 214 | + | * After updating, check that the correct config is still being used | |
| 215 | + | See the file "lazarus.cfg" in the installation directory. And Menu "View" > "IDE Internals" > "About IDE" | |
| 220 | 216 | ||
| 221 | - | ||
| 217 | + | The Windows Installer is able to create secondary installations, which allows you to have different versions installed that do not interfere with each other. | |
| 222 | 218 | ||
| 223 | - | ||
| 219 | + | All you need to do is tick the checkbox "secondary installation" (when choosing the install directory), and follow the instructions. You will then be asked for a new empty folder where the config will be stored (this can be a subfolder in the install directory). | |
| 224 | 220 | ||
| 225 | - | ||
| 221 | + | If you update an installation using the Windows Installer, it will detect when the selected directory contains a secondary install. | |
| 226 | 222 | ||
| 227 | - | ||
| 223 | + | In order to always be able to quickly see which IDE you are using, and also to check that the correct config is loaded, it is advisable to make changes to some visual attributes. A possibility is to change the gutter color in the editor. | |
| 228 | 224 | ||
| 229 | 225 | #### Windows - Adding a cross compiler install | |
| 230 | 226 | ||
| 231 | - | ||
| 227 | + | The installation packages for cross compilers can be added to secondary installations, too. However, they will currently give a warning that the folder is not empty. This warning can be ignored. | |
| 232 | 228 | ||
| 233 | 229 | # Visually distinguish | |
| 234 | 230 | ||
| 235 | - | ||
| 231 | + | To distinguish each Lazarus visually you can: | |
| 236 | 232 | ||
| 237 | - | ||
| 238 | - | ||
| 233 | + | * Set a different color for the gutter - the left column of the source editor where the line numbers and break points are shown. | |
| 234 | + | * Set the title of the IDE | |
| 239 | 235 | ||
| 240 | 236 | --- | |
| 241 | - | ||
| 237 | + | *From the Free Pascal wiki, page "Multiple Lazarus", as the Internet Archive kept it on 2026-01-13, last changed on 2025-07-22. Copyright stays with the author who wrote it, according to the old wiki's [[Licensing]] page. If you have concerns about this material, [message the admin](/wiki-contact).* |