Sign in Join
Wiki copytemporary

Installation hints for old versions: what changed

Revision 1 to 2. Removed lines have a minus sign; added lines have a plus sign.

OldNewLine
11## Installing Lazarus
22
33### Installing Lazarus under Linux
44
55#### Ubuntu / Debian
66
77##### Problems compiling GTK2 apps with FPC 2.2.2
88
99From this [post](http://lists.freepascal.org/lists/fpc-pascal/2009-January/019838.html) by Michalis Kamburelis:
1010
1111In case someone wonders how to workaround this [bug](http://mantis.freepascal.org/view.php?id=11837) (occurs with GTK \>= 2.13.4, e.g. on Ubuntu 8.10 we have GTK 2.14):
1212
1313I found that the quick workaround that works is to pass --noinhibit-exec to ld, that is "-k--noinhibit-exec" to FPC command-line. The ld will then treat unresolved references as mere warnings, and will produce working executable (assuming your program doesn't actually call obsoleted GTK2 functions).
1414
1515Of course, you can also upgrade to the lastest FPC release 2.2.4. Above workaround is useful only if you have to stick to old released FPC 2.2.2.
1616
1717#### Installing 0.9.28 using rpms
1818
1919The next easiest way is to the RPMs for FreePascal and Lazarus from the SourceForge repository.
2020
2121You need to download the selected version of
2222
2323- the compiler (eg fpc-2.2.4-0.i386.rpm)
2424- the pascal source library (eg fpc-src-2.2.4-081004.i386.rpm)
2525- the Lazarus package (eg lazarus-0.9.28-0.i386.rpm).
2626
2727Here is an example of a script to install or update to ver.0.9.28. Save it as something like "InstallLazarus.sh", give it execute permission, and run after getting root privileges using su. Don't mind if you get "not installed" message.
2828
2929` #!/bin/sh`\
3030` URL=`[`http://sourceforge.net/projects/lazarus/files/Lazarus%20Linux%20i386%20RPM/Lazarus%200.9.28`](http://sourceforge.net/projects/lazarus/files/Lazarus%20Linux%20i386%20RPM/Lazarus%200.9.28)\
3131` wget $URL/fpc-2.2.4-0.i386.rpm/download`\
3232` wget $URL/fpc-src-2.2.4-0.i386.rpm/download`\
3333` wget $URL/lazarus-0.9.28-0.i386.rpm/download`\
3434` rpm -ev lazarus`\
3535` rpm -ev fpc`\
3636` rpm -ev fpc-src`\
3737` rpm -ivh fpc-*`\
3838` rpm -ivh lazarus-*`
3939
4040#### Installing on Mandriva
4141
4242##### Lazarus 0.9.30 on Mandriva 2010
4343
4444Install as given lower down however on compiling a program you may get two error messages telling you that you are missing pixbuf 2.0 and lgtk-x11-2.0. to fix this install from the the software installer libdgk_pixbuf2.0_0-devel and libgtk+2.0_0-devel.
4545
4646##### Lazarus 0.9.28 on Mandriva 2010
4747
4848Install as given lower down however on compiling a program you may get two error messages telling you that you are missing pixbuf 2.0 and lgtk-x11-2.0. to fix this install from the the software installer libdgk_pixbuf2.0_0-devel and libgtk+2.0_0-devel.
4949
5050##### Lazarus 0.9.28 on Mandriva 2009 (2009.0) (i386) (GTK-2)
5151
5252Not much has changed compared to Mandriva 2007. The following instruction shall not differ for an x86_64 architecture.
5353
54541/ Do not install FPC from Drake. If you have done so, desinstall it. Since Mandriva does not provide the complete set of tools (FPC+sources+documentation+Lazarus) it is better, in my opinion, to have complete control on all of them through rpms.
5555
56562/ Collect fresh rpms on sourceforge (http://sourceforge.net/project/showfiles.php?group_id=89339): select the RPM version of the latest lazarus release compatible with your architecture and download fpc, fpc-src, fpc-docs and lazarus RPMs.
5757
58583/ Browse the directory where you downloaded the RPMs (with Nautilus or whatever file browser your using) and double click on the RPMs in this ordrer:
5959
6060`  (a) fpc-<version>-<arch>.rpm`\
6161`  (b) fpc-docs-<version>-<arch>.rmp`\
6262`  (c) fpc-src-<version>-<arch>.rpm`\
6363`  (d) lazarus-<version>-<arch>.rpm`
6464
65654/ It is possible that the Drake (the software that will manage your RPMs) will complain about missing libraries or tools. Use Drake to collect them. For instance, you shall have installed developpement tools such as "GNU Make". Search and if necessary install "GNU Make". You might be missing the ld (the linkage utility), you can install for instance the "gcc" package.
6666
67675/ As before, it is possible to search for and install "galaxy-gnome" and "gtk-switch" with Drake. Nonetheless, they are not required for Lazarus to work properly. Gnome Galaxy are a set of cool themes you can use in the System menu-\>Preferences-\>Themes.
6868
69696/ Lazarus might complain about the FPC sources that are not correctly set. Go to Configuration-\>Environement then set the FPC sources directory to your local installation (it should be /usr/local/fpcsrc/\<version\>/).
7070
71717/ When launched, the libcanberra-module-gtk might not be found. I tried to build a symlink (ln -s) but if Lazarus manages to find this library... it crashes. It might be safer to ignore this error.
7272
73738/ Have fun with the coolest RAD of the Free World.
7474
7575##### Lazarus 0.9.26 on Mandriva 2007 (2007.0) (i386) (GTK-1)
7676
7777Installation in Mandriva is very easy. However, there are a few points to check as the installation proceeds. Here is a typical installation using the .tar modules (see the trick for the theme at the end of the procedure!):
7878
7979\- During the Mandriva installation, select the "Gnome desktop" group. Although you will use lazarus in KDE or other desktop, this will install some GTK modules needed by the lazarus environment.
8080
8181\- Install the FPC 2.2.2 compiler using either the .rpm or .tar, modules. Using the .tar modules you would type: "sh install.sh" then RETURN many times. I do this in superuser mode.
8282
8383\- Install the compiler source code. just untar the file "fpc-src-2.2.4.source.tgz" in the folder /usr/local/src/fpc/ then rename the created folder "fpc" to "2.2.2" . When complete, you have the folder /usr/local/src/fpc/2.2.2/ that contains all the source code. The source code is only needed by lazarus editor, but you can recompile FPC and have an optimized version of the libraries, and show that everything is working well:
8484
8585\- If you want to compile FPC (optional), then go to the FPC source directory (/usr/local/src/fpc/2.2.4/) and type "./configure", "make clean","make all","make install","make clean". FPC is now installed. Check the content of "/etc/fpc.cfg". This file has to be modified when the make fails.
8686
8787\- Lazarus can be installed in user mode: just unzip/untar the file "lazarus-0.9.26.0.tar.gz" in your user directory. Then just type "make clean all" in the user mode. The last phase of the process (link) usually fails due to missing library files:
8888
8989\- Check in the directory /usr/lib/ for the following symbolic links:
9090
9191libglib.so -\> libglib-1.2.so.0
9292
9393libgtk.so -\> libgtk-1.2.so.0.9.1
9494
9595libgdk.so -\> libgdk-1.2.so.0.9.1
9696
9797libgdk_pixbuf.so -\> libgdk_pixbuf.so.2.0.0
9898
9999The file "libgdk_pixbuf.so.2.0.0" is included in the module "libgdk_pixbuf-2.0.22.0-10mdv2007.0.rpm" This file name is critical. In particular, DO NOT use "libgdk_pixbuf-2.0.so.0" (misleading isn't!).
100100
101101After all the links have been fixed, the "Linking ../lazarus" stage will not crash any more and the "./lazarus" command should start the program!
102102
103103\- Go to the "environment/environment options" menu and change the "FPC source directory" to /user/local/src/fpc/2.2.4
104104
105105USEFUL TO KNOW:
106106
107107\- The last step is to fix the theme. The package "galaxy-gnome-1.0.4-3mdv2007.0" is available in the Mandriva control center. Install it.
108108
109109\- The package "gtk-theme-switch-1.0.1-4mdv2007.0.i586.rpm" is available on the web! (strangely it did not show in the control center) Install it manually by typing "rpm -iv --test gtk-theme-switch-1.0.1-4mdv2007.0.i586.rpm" then retype the line without the "--test" in my case there was a warning message related to the signature. I decided to ignore it!
110110
111111\- in the USER MODE, type "switch", then chose "galaxy" theme.
112112
113113The Lazarus / FPC tool is now installed!
114114
115115##### Lazarus 0.9.28 on Mandriva 2007/or -2006 32 bit
116116
117117Write this urpmi-command as root:
118118
119119 urpmi http://surfnet.dl.sourceforge.net/sourceforge/lazarus/lazarus-0.9.28-0.i386.rpm http://surfnet.dl.sourceforge.net/sourceforge/lazarus/fpc-2.2.4-0.i386.rpm http://surfnet.dl.sourceforge.net/sourceforge/lazarus/fpc-docs-2.2.4-0.i386.rpm http://surfnet.dl.sourceforge.net/sourceforge/lazarus/fpc-src-2.2.4-0.i386.rpm
120120
121121Lazarus 0.9.28 depends on fpc 2.2.4 and Mandriva 2007 is shipped with fpc-2.1.1-0.2mdk.i586. To prevent your system to upgrade to fpc-2.1.1 or newer in the future, when you run commands as urpmi --auto-select, you can write fpc in /etc/urpmi/skip.list.
122122
123123##### Lazarus 0.9.28 on Mandriva 2009 32 bit
124124
125125Installation needs similar action as above. Because the distribution comes with fpc-2.2.4-1, it is necessary to uninstall this package. Write following commands as root:
126126
127127 rpm -e fpc
128128 urpmi http://surfnet.dl.sourceforge.net/sourceforge/lazarus/lazarus-0.9.28-0.i386.rpm http://surfnet.dl.sourceforge.net/sourceforge/lazarus/fpc-2.2.4-0.i386.rpm http://surfnet.dl.sourceforge.net/sourceforge/lazarus/fpc-docs-2.2.4-0.i386.rpm http://surfnet.dl.sourceforge.net/sourceforge/lazarus/fpc-src-2.2.4-081004.i386.rpm
129129
130130And place fpc in /etc/urpmi/skip.list.
131131
132132##### Lazarus untested snapshot on Mandriva 2007 32 bit
133133
134134 urpmi $(for RPM in $(lynx --source http://michael-ep3.physik.uni-halle.de/Lazarus/ | grep i386.rpm | cut -d '"' -f 4-4) ; do echo -n http://michael-ep3.physik.uni-halle.de/Lazarus/$RPM ' '; done )
135135
136136##### Installing Lazarus + fpc For Mandriva X86_64
137137
138138This was tested on Mandriva 2010.0 X86_64.
139139
140140- Download the X86_64 snapshots from <http://michael-ep3.physik.uni-halle.de/Lazarus/> Lazarus Snapshots
141141- I used these:
142142
143143 http://michael-ep3.physik.uni-halle.de/Lazarus/snapshots/fpc-2.4.0-20100412.x86_64.rpm
144144 http://michael-ep3.physik.uni-halle.de/Lazarus/snapshots/fpc-src-2.4.0-20100412.x86_64.rpm
145145 http://michael-ep3.physik.uni-halle.de/Lazarus/snapshots/lazarus-0.9.29.24591-20100412.x86_64.rpm
146146
147147You can install them with the command urpmi as root, and write all these 3 urls as paramters on the command line.
148148
149149- To download and install the current snapshot:
150150
151151`urpmi $(lynx --source `[`http://michael-ep3.physik.uni-halle.de/Lazarus/`](http://michael-ep3.physik.uni-halle.de/Lazarus/)` |grep -v lazarus-0.9.28.3| grep 64.rpm | cut -d '"' -f 6-6 | awk '{print "`[`http://michael-ep3.physik.uni-halle.de/Lazarus/"$0`](http://michael-ep3.physik.uni-halle.de/Lazarus/%22$0)`}')`\
152152You might have to install lynx and make first:`urpmi lynx make`.
153153
154154- Once the RPMs have been installed. Run lazarus for the first time. It will pop up a dialog complaining that the "/usr/bin/ppc386" and "/usr/lib/lazarus" are not valid. Accept ("OK") the alternate choices it suggests.
155155- When compiling your first project, you may find that lazarus complains of missing libs (e.g. gdk, glib, etc.). Install the necessary libs as needed, I installed these (that I recall, YMMV):
156156
157157 glib-devel
158158 lib64gtk+1.2-devel
159159 lib64gtk+2.0_0-devel
160160 lib64gdk-pixbuf2
161161 lib64gdk-pixbuf2-devel
162162
163163#### Installing on Slackware
164164
165165##### Installing Lazarus on Slackware 13.0
166166
167167There is no real difference from the slackware 12.2 or 12.0 version, therefore the procedure described below should work just as well.
168168
169169Please note that you will NOT be able to install lazarus on gtk, therefore you MUST use the "LCL_PLATFORM=gtk2" statement. Slackware only provides the KDE enviroment, but the gtk2 type panels are fully supported (no extra installation required). At most, there is one or two symbolic link to add!
170170
171171##### Installing Lazarus 0.9.28, for Slackware 12.0 users
172172
173173This have worked in Slackware-12.0 on a Pentium-3 computer:
174174
175175- The Free Pascal Compiler (FPC) is installed in SUPERUSER mode
176176- The lazarus in installed in USER mode
177177- The FPC compiler will be recompiled
178178- The lazarus Integrated Development Environment (IDE) source code is loaded from the SVN server
179179- The GTK-2 widget set is used ("LCL_PLATFORM=gtk2")
180180
181181-- Download "fpc-2.2.4.i386-linux.tar" in a user folder and install it. Go to this folder and type:
182182
183183` bash-3.1$ tar -xvf fpc-2.2.4.i386-linux.tar`\
184184` bash-3.1$ su `\
185185` bash-3.1$ password:xxxxxx`\
186186` bash-3.1# sh install.sh`\
187187` ...`\
188188` (use the default answers for the next 6 questions: press "return" 6 times)`\
189189` ...`\
190190` bash-3.1# exit`\
191191` bash-3.2$ fpc`\
192192` free pascal compiler version 2.2.4 [] for i386 `\
193193` Copyright (c) 2008 ...`\
194194` ...`\
195195` ...`
196196
197197You have installed the compiler. You may want to recompile it or not, but in any case you will need to download the source code as it is required by the lazarus IDE.
198198
199199-- Download "fpc-2.2.4.source.tar.gz" in a temporary folder. If you do not want to recompile the source then just skip this section. If you would like to run your own compiled version of FPC, then just type:
200200
201201` bash-3.1$ tar -xvzf fpc-2.2.4.source.tar.gz`\
202202` bash-3.1$ cd fpc-2.2.4`\
203203` bash-3.1$ make clean all`\
204204` bash-3.1$ su`\
205205` bash-3.1$ password: xxxxxxxx`\
206206` bash-3.1# make install`\
207207` bash-3.1# exit`\
208208` bash-3.1$ fpc`\
209209` free pascal compiler version 2.2.4 [...] for i386 `\
210210` Copyright (c) 2008 ...`\
211211` ...`\
212212` ...`
213213
214214Now you have your own compiled version working.
215215
216216-- The lazarus IDE editor needs to look at the FPC source code. Even if you do not want to recompile FPC, you need its source code. However, in order to save some space, I only keep a clean (not compiled) copy of the source code. I start from the file "fpc-2.2.4.source.tar.gz" again and I copy it to the /usr/local/src/FPC folder:
217217
218218` bash-3.1$ su`\
219219` bash-3.1$ password: xxxxxxxx`\
220220` bash-3.1# cp fpc-2.2.4.source.tar.gz /usr/local/src/`\
221221` bash-3.1# cd /usr/local/src/`\
222222` bash-3.1# tar -xvzf fpc-2.2.4.source.tar.gz`\
223223` bash-3.1# rm fpc-2.2.4.source.tar.gz`\
224224` bash-3.1# exit`
225225
226226The version number is included in the folder name "fpc-2.2.4". This way I can keep many versions the the compiler source and eventually switch between them.
227227
228228-- The lazarus IDE is kept in my USER "~/lazarus" folder and always compiled in USER mode. I usually download the "lazarus-0.9.28-0.tar.gz" file, but here we can also get the latest development version from the SVN server:
229229
230230`  bash-3.1$ svn co `[`http://svn.freepascal.org/svn/lazarus/trunk`](http://svn.freepascal.org/svn/lazarus/trunk)` lazarus`
231231
232232This is for the first time you load it. Next time you will only need to type:
233233
234234`  bash-3.1$ svn update`
235235
236236If you do not have SVN installed on your computer, here is how to get it quickly:
237237
238238--Download the two files: "subversion-1.4.6.tar.gz" and "subversion-deps-1.4.5.tar.gz" (or later versions). Type:
239239
240240`  bash-3.1$ tar -xvzf subversion-1.4.6.tar.gz`\
241241`  bash-3.1$ tar -xvzf subversion-deps-1.4.6.tar.gz`\
242242`  bash-3.1$ cd subversion-1.4.6`\
243243`  bash-3.1$ ./configure`\
244244`  bash-3.1$ make`\
245245`  bash-3.1$ su`\
246246`  bash-3.1$ password:xxxxxx`\
247247`  bash-3.1# make install`\
248248`  bash-3.1$ exit`
249249
250250-- At this point you have the folder "~/lazarus" containing the source code. You should compile it very simply:
251251
252252`  bash-3.1$ make clean all LCL_PLATFORM=gtk2`
253253
254254The "LCL_PLATFORM=gtk2" means of course that you will develop your applications in GTK-2. The default widget set for lazarus is GTK-1 but you will not be able to use it in Slackware 12.0. I strongly recommend that you use the "LCL_PLATFORM=gtk2" option now. After a few minutes, the compiler stops:
255255
256256`  ...`\
257257`  ...`\
258258`  Linking ../Lazbuild`\
259259`  987 linescompiled ...`\
260260`  make [2] leaving ...`\
261261`  make [1] leaving ...`\
262262`  bash-3.1$`
263263
264264-- Just type:
265265
266266`  bash-3.1$ ./lazarus`
267267
268268WOW! You get a message: "Free Pascal sources not found". Just follow the instructions and indicate your Free Pascal Compiler source directory in the panel: "Environment-\>Environment_Options-\>Files". As explained earlier, on my computer this should point to "/usr/local/src/fpc-2.2.4". Note that when you change this folder, you should click on "Environment / Rescan_FPC_source_directory".
269269
270270Voila!
271271
272272#### Installing on openSUSE
273273
274274##### Installing Lazarus 0.9.30. For openSUSE 11.1
275275
276276Free Pascal Compiler requires:\
277277\- Gnu binutils (gnu as, gnu ld, gnu make)
278278
279279These utils can be installed by:
280280
281281``` bash
282282zypper in -t pattern devel_basis
283283```
284284
285285Lazarus also requires these components: 1) glib2 devel 2) gtk2 devel
286286
287287**Important**: The lazarus rpm requires the gtk 2 version, not the version 1.2.
288288
289289These libraries can be installed by:
290290
291291``` bash
292292zypper -n install gtk2 glib2
293293```
294294
295295Download these binary files (RPM)
296296
297297:* fpc-2.4.2-0.i686.rpm (yes i686 and not i386)
298298
299299:* fpc-src-2.4.2-0.i686.rpm
300300
301301:* lazarus-0.9.30-0.i686.rpm
302302
303303install them opening a terminal session (mouse's right button -\> Menu: Open in terminal)
304304
305305``` bash
306306rpm -Uvh fpc-2.4.2-0.i686.rpm
307307rpm -Uvh fpc-src-2.4.2-0.i686.rpm
308308rpm -Uvh lazarus-0.9.30-0.i686.rpm
309309```
310310
311311##### Installing Lazarus 0.9.28. For openSUSE 11.1 users
312312
313313Free Pascal Compiler requires:\
314314\- Gnu binutils (gnu as, gnu ld, gnu make) These utils can be installed by:
315315
316316` zypper in -t pattern devel_basis`
317317
318318Lazarus also requires these components: 1) glib2 devel 2) gtk2 devel
319319
320320**Important**: The lazarus rpm requires the gtk 2 version, not the version 1.2.
321321
322322These libraries can be installed by:
323323
324324` zypper -n install gtk2 glib2`
325325
326326Download these binary files (RPM)
327327
328328:* fpc-2.2.4-0.i386.rpm (yes i586 and not i386)
329329
330330:* fpc-src-2.2.4-0.i386.rpm
331331
332332:* lazarus-0.9.28.2-0.i586.rpm
333333
334334install them opening a terminal session (mouse's right button -\> Menu: Open in terminal)
335335
336336` rpm -Uvh fpc-2.2.4-0.i386.rpm`\
337337` rpm -Uvh fpc-src-2.2.4-0.i386.rpm`\
338338` rpm -Uvh lazarus-0.9.28.2-0.i586.rpm`
339339
340340#### Install Lazarus 0.9.4 on Mandrake 10.1
341341
342342Do the following steps to install your Lazarus Integrated Development Tool, with the Free Pascal Compler.
343343
344344I am a novice linux user. I find it so difficult to install or upgrade software on linux. This time I finally succeeded upgrading lazarus to the 0.9.4 version (3 jan 2005 version) and I hope that this sumary could be usefull for other novice users.
345345
346346- System: linux "Mandrake 10.1 Official" on a Pentium III (or II) type computer.
347347
348348- Lazarus: Version 0.9.4 (built: 3 january 2005).
349349
350350- FPC: Version 1.9.6 (built: 2 january 2005).
351351
352352- File names:
353353
354354`   File_1 = "fpc-1.0.10i386.tar" from:`\
355355`   `[`http://www.freepascal.org/down-linux-1386.html`](http://www.freepascal.org/down-linux-1386.html)
356356
357357`   File_2 = "fpc-1.9.6-050102.i386-linux.tar" from:`\
358358`   `[`http://www.lazarus.freepascal.org`](http://www.lazarus.freepascal.org)\
359359`   then follow the links: "binaries" / "linux" / "Current Lazarus Binary`\
360360`   RPM"`
361361
362362`   File_3 = "lazarus-050103.tgz" (from the lazarus site)`
363363
364364- System modules: Lazarus uses the GTK+ library (version 1 only, not version2). Go the "Mandrake Control Center" and install the modules:
365365
366366`      libgdk-pixbuf-xlib2-0.22.0-5mdk `\
367367`      libgdk-pixbuf2-devel-0.220.-5mdk `\
368368` `
369369
370370There are 3 steps:
371371
372372`   Step A - Install the stable compiler (V1.0.10)`\
373373`   Step B - Install the current compiler (V1.9.6)`\
374374`   Step C - Install the Integrated Development Environment (Lazarus)`\
375375`   Step A - Install the stable compiler (FPC Version 1.0.10)`
376376
377377##### Step A - Install the stable compiler (FPC Version 1.0.10)
378378
379379In order to compile the compiler, you need a compiler! We use the "stable compiler", (Free Pascal Compiler version 1.0.10) for that. It used to be included on the "Mandrake Install disk" but I did not find it in the Mandrake 10.1 distribution! However, it is available on the web (see the address above):
380380
381381`   A.1- In user mode ("myself") type: mkdir /home/myself/freepascal/V1.0.10`\
382382`   A.2- copy File_1 to /home/myself/freepascal/V1.0.10`\
383383`   A.3- type: tar -xvf File_1 (of course you type the actual `\
384384`   file name given above)`\
385385`   A.4- type: cd fpc`\
386386`   A.5- go to the superuser mode (type: "su" then your password)`\
387387`   A.6- type: sh install.sh`\
388388`   A.7- you want to install it in the [/usr/local folder] then `\
389389`   just press: return`\
390390`   A.8- anwser "Y" to all the 11 questions, and answer "return" `\
391391`   to the last question.`
392392
393393At this point you shoud have the first "stable" compiler installed! It will be used to compile the "current" compiler: The command: "fpc" shows a help message that shows the "1.0.10" version number. Also, check that now you have the folder:
394394
395395`   /usr/local/lib/fpc/1.0.10/`
396396
397397##### Step B - Install the current compiler (FPC Version 1.9.6)
398398
399399This is very similar to the previous section:
400400
401401`   B.1- In user mode ("myself") type: mkdir /home/myself/freepascal/V1.9.6`\
402402`   B.2- move File_2 to: /home/myself/freepascal/V1.9.6`\
403403`   B.3- type: tar -xvf File_2 (actual name given above)`\
404404`   B.4- type: cd fpc`\
405405`   B.5- go to the superuser mode ("su")`\
406406`   B.6- type: sh install.shl (takes about 10 minutes)`\
407407`   B.7- anwser "Y" to all the 12 questions, and answer "return" to the last`\
408408`   question.`
409409
410410At this point check that you have a directory:
411411
412412`   /usr/local/lib/fpc/1.9.6/units/i386-linux/`
413413
414414filled with the libraries. There are all sort of folders in there. Now check that the file fpc.cfg has the lines:
415415
416416`   -Fu/usr/local/lib/fpc/1.9.6/units/$fpctarget `\
417417`   -Fu/usr/local/lib/fpc/1.9.6/units/$fpctarget/* `\
418418`   -Fu/usr/local/lib/fpc/1.9.6/units/$fpctarget/rlt `
419419
420420Note that you see the word: \$fpctarget NOT \$target. Note that you see: 1.9.6 NOT 1.0.10. If the lines do not match then edit and change the file. Use any editor you like of course. In VI (type: "vim") you type:
421421
422422`   B.7.a - "I" to go to the "insert" mode`\
423423`   B.7.b - type in your lines as shown above`\
424424`   B.7.c - press "ESCAPE" to go back to the command mode`\
425425`   B.7.d - type ":wq" to save and exit. (":q!" exit without save!)`
426426
427427The last "trick" is to check (and change, if necessary) that the symbolic link "ppc386" points to the good compiler. Type:
428428
429429`   B.8.a- cd /usr/local/bin`\
430430`   B.8.b- ls -al`
431431
432432The displayed line should show:
433433
434434`   ppc386 --> /usr/local/lib/fpc/1.9.6/ppc386`
435435
436436If it does, then skip to step B9, otherwise type :
437437
438438`   B.8.c- rm ppc386 (then "y")`\
439439`   B.8.d- type: ln -s /usr/local/lib/fpc/1.9.6/ppc386`\
440440`   B.9 - Go back to the user mode (type: "exit").`\
441441`   B.10- type: fpc`
442442
443443Wonderfull! Now you see from the help message that you have the version 1.9.6 compiler. The last step is to load the IDE.
444444
445445##### Step C - Install the Integrated Development Environment (Lazarus)
446446
447447The Lazarus can installed in your own user account ("myself"). That can be done in the user mode:
448448
449449`   C.1- type: cd ~`\
450450`   C.2- Copy File_3 to: /home/myself/`\
451451`   C.3- cd ~`\
452452`   C.4- tar -xvzf File_3 this will create the lazarus folder`\
453453`   C.5- cd lazarus`\
454454`   C.6- make clean all (takes about 10 minutes)`\
455455`   C.7- type: ./lazarus`
456456
457457This should bring up the IDE. The first time you run lazarus, you get an error message about a bad "Free pascal Source Directory". Click: "ignore", then go to the menu: "Enviromnment/Environment Options" and set the "FPC source directory" to /usr/local/share/src/fpc-1.9.6/.
458458
459459`   C.8- In order to check that the application is working properly,`\
460460`   create the simplest application. Just drag and drop a button on `\
461461`   the form and press F9.`\
462462`   C.9- Finally, create a shortcut icon on your desktop that executes lazarus`\
463463`   in the /home/myself/lazarus/ directory. Enjoy.`
464464
465465Finally, I would like to make a few comments:
466466
467467- I do not know how to install the .rpm files. For that reason I always use the .tar files. Most people commented to me that the RPM file is a prefered method.
468468- There is a stable version 1.0.11 but there was no .tar file available for this one. The version 1.10 is available and works well, so I used it.
469469- If you get an error message about some files "missing" this is because you have not installed some modules. Instaling modules is an art (and a hobby)! Try to install the followings modules. I do not know if they are nessary but they were already installed on my system:
470470
471471`      kernel-source-2.6-2.6.8.1-12mdk  `\
472472`      libgdk-pixbuf2.0-0-devel-2.4.9-9mdk  `
473473
474474- Beware of the files "ppc386" "ppc396.cfg" "fpc.cfg" "fpc" when your instalation fails. After a while, you see them everywhere. Some of them are hidden sometimes! Remove all those files before you start the instalation again. Only /etc/fpc.cfg and /user/lib/ppc386 are necessary.
475475
476476- FPC can be installed in the cross-compiler (multi-platform) mode. The file to use for that has the name structure "fpcsrc-...-.tar". I could install it, but more difficult to install. In this this procedure however, the "linux-only" file ("fpc-...-linux.tar") is very easy to install.
477477
478478I hope that this was not too pedantic and could be useful to someone. I wish you a good luck. Alain Michaud 31 January 2005
479479
480480#### Installing from source
481481
482482If you prefer to install from source and compile the files yourself, follow these instructions. Because the whole lazarus stuff is installed into one directory, uninstall is very easy and you don't need to be root to install lazarus. You can get tgz files for fpc, fpcsrc and lazarus from the downloads section or you can download it directly via svn.
483483
484484Here is an example of installing 0.9.28 to Ubuntu 6.06. If you understand Linux commands and bash script, you can get what steps are needed. Just copy the script (change the version number when new version has been released), paste it into a text editor, and save it as something like "install_lazarus.sh". Give it execute permission, and run it in a console. Note: In this example, fpc is installed in /opt. So when prompted 'Install prefix', enter '/opt/fpc'.
485485
486486` #!/bin/sh`\
487487` `\
488488` #installing required packages`\
489489` sudo apt-get install build-essential`\
490490` sudo apt-get install libgtk2.0-dev`\
491491` sudo apt-get install libgdk-pixbuf-dev`\
492492` `\
493493` #installing FreePascal source`\
494494` cd /opt`\
495495` sudo wget `[`http://nchc.dl.sourceforge.net/lazarus/fpc-src-2.2.4.source.tgz`](http://nchc.dl.sourceforge.net/lazarus/fpc-src-2.2.4.source.tgz)\
496496` sudo tar -xvf fpc-src-2.2.4.source.tgz`\
497497` sudo mv fpc fpcsrc`\
498498` `\
499499` #installing FreePascal`\
500500` sudo mkdir fpc`\
501501` cd fpc`\
502502` sudo wget `[`http://nchc.dl.sourceforge.net/lazarus/fpc-2.2.4.i386-linux.tar`](http://nchc.dl.sourceforge.net/lazarus/fpc-2.2.4.i386-linux.tar)\
503503` sudo tar -xvf fpc-2.2.4.i386-linux.tar`\
504504` echo "Enter '/opt/fpc' when prompted 'Install prefix'"`\
505505` sudo sh install.sh`\
506506` `\
507507` #adding fpc path to the PATH`\
508508` echo "#FPC PATH" >> ~/.bash_profile`\
509509` echo "if [ -d /opt/fpc/bin ] ; then" >> ~/.bash_profile `\
510510` echo PATH=/opt/fpc/bin:"${PATH}" >> ~/.bash_profile`\
511511` echo "fi" >> ~/.bash_profile`\
512512` `\
513513` #installing Lazarus`\
514514` cd ../`\
515515` sudo wget `[`http://nchc.dl.sourceforge.net/lazarus/lazarus-0.9.28-0.tar.gz`](http://nchc.dl.sourceforge.net/lazarus/lazarus-0.9.28-0.tar.gz)\
516516` sudo tar -zxvf lazarus-0.9.28-0.tar.gz`\
517517` PATH=/opt/fpc/bin:"${PATH}"`\
518518` sudo chmod -R 777 lazarus`\
519519` cd lazarus`\
520520` make clean all`\
521521` ./lazarus`
522522
523523Note: You have to manually set fpc-src path in the Environmental Options.
524524
525525##### Downloading Lazarus Source Code
526526
527527The lazarus repository has moved from cvs to svn (Subversion). SVN provides an easy way to update your sources by only downloading the changes. This is the recommended way and saves you a lot of time. A connection to the internet is needed for this: you don't need to be root.
528528
529529Please note these instructions are for SubVersion.
530530
531531Lazarus does not need any special permissions, neither during installation nor at runtime.
532532
533533With the move we also changed the directory layout of the lazarus sources. The main difference is that all ide sources are moved from the root to a separate ide subdir. As anybody might understand, this has an impact on the Makefiles, the searchpaths etc. We are in progress of fixing things, so if something doesn't work, please let us know.
534534
535535Now the most important thing.... getting the sources
536536
537537` []$ svn checkout `[`http://svn.freepascal.org/svn/lazarus/trunk/`](http://svn.freepascal.org/svn/lazarus/trunk/)` lazarus`
538538
539539(or any other dir where you want to place your sources)
540540
541541On subsequent occasions, to update simply type
542542
543543` []$ svn update lazarus`
544544
545545For more information on Subversion, see: <http://subversion.tigris.org/>
546546
547547Note: the CVS is still accessable, but is frozen. This means that no new updates are comitted.
548548
549549##### Compiling and running
550550
551551Whether you checkout from cvs or svn, the next step is:
552552
553553compile lazarus
554554
555555`[]$ cd lazarus`\
556556`[]$ make  (gmake on BSD)`
557557
558558If fpc is installed correctly, the compilation should work without problems. If not, see FAQ.
559559
560560Start lazarus
561561
562562`[]$ ./lazarus`
563563
564564The IDE should start. If you started lazarus in a terminal, you can see some notes about missing settings. This is normal at first start. The IDE automatically tries to find out where the freepascal compiler and its sources are installed by searching in the most common directories.
565565
566566Check the paths
567567Use the IDE menu to go to
568568
569569
570570Environment -\> Environment Options -\> Files
571571
572572The 'FPC Source directory' should point to your fpc source directory. This directory normally ends with /fpc/ or /fpcsrc/ (e.g. /usr/src/fpcsrc or /home/username/freepascal/fpc) and contains directories like 'compiler', 'docs', 'fcl', 'rtl' and 'packages'.
573573
574574See here for the documentation about this dialog: [[IDE Window: Environment Options]]
575575
576576Hint
577577
578578To update lazarus you can use
579579
580580`[]$ svn update lazarus`
581581
582582then for either update pathway:
583583
584584`[]$ make clean all   (gmake on BSD)`
585585
586586This will rebuild lazarus and create an IDE without lazarus packages. To link your installed packages do **after** the above:
587587
588588`[]$ ./lazbuild --build-ide=`
589589
590590You may have to append other options if for example you use a custom config directory (ie. add --pcp="C:\Documents and Settings\\\<USER\>\Local Settings\Application Data\lazarus-tests")
591591
592592#### Installing Lazarus under Debian GNU/Linux
593593
594594There are preliminary Debian packages for lazarus available for download. They are not the latest versions, however. Make sure you read /usr/share/doc/lazarus/README.Debian carefully before you start using it. Feedback is needed and appreciated; please send your comments to Carlos Laviola \<claviola@debian.org\>.
595595
596596Note that for a fully working Lazarus install, no older or incompatible versions of, for example, the fpc source or fpc compiler must be installed. Remove them by typing
597597
598598` dpkg -r <package name>   `
599599
600600without .deb extension. And then install the newest versions as described.
601601
602602#### Installing Lazarus 64 bit version on Red Hat EL 5
603603
604604Linking may fail when you do your first compile with an error "incompatible libglib" if the following symbolic links are not present in the /usr/lib64/ directory
605605
606606libglib.so -\> libglib-1.2.so.0 libgtk.so -\> libgtk-1.2.so.0.9.1 libgdk.so -\> libgdk-1.2.so.0.9.1
607607
608608The steps for successful installation on Red Hat were
609609
610610yum install gimp gimp-devel gtk+* gtk+-devel
611611
612612Then install the following rpms
613613
614614fpc-2.2.4-0.x86_64.rpm fpc-docs-2.2.4-0.x86_64.rpm lazarus-0.9.28.2-0.src.rpm lazarus-debuginfo-0.9.28.2-0.x86_64.rpm fpc-2.2.4-3.fc10.x86_64.rpm fpc-src-2.2.4-091006.x86_64.rpm lazarus-0.9.28.2-0.x86_64.rpm
615615
616616add -Fl/usr/lib64 under \#ifdef cpux86_64 in fpc.cfg
617617
618618Then add the symbolic links listed above.
619619
620620#### Fedora Core 11
621621
622622Needed packages:
623623
624624`gtk2-devel glibc-devel binutils`
625625
626626Useful packages for development:
627627
628628`subversion wget gcc bison rpm-build`
629629
630630### Installing Lazarus under Windows
631631
632632The current releases of the Windows Lazarus binary packages install very easily, and should work 'out-of-the-box'.
633633
634634It is even possible to install the whole Lazarus/FPC package on a portable USB drive (capacity at least 256 MB), for use in environments where you are not allowed to install software on your Windows workstation or where you haven't got administrator privileges. You do have to be a little careful about adjusting the paths in the compiler and environment options and the fpc.cfg file. It may also be necessary to keep the directory for test compilation on your portable drive.
635635
636636\<\< Q:DOES ANYONE KNOW HOW TO SET UP RELATIVE PATHS IN THESE TAGS AND FILES, SO THAT THE ADDRESSING WORKS WHEN YOU MOVE THE USB DEVICE TO ANOTHER MACHINE WHERE IT HAS A DIFFERENT DRIVE LETTER?
637637
638638A: This is what I do. It's relatively convoluted, but it's the best solution I've found. I have a "bin" directory on my USB drive, where I have several scripts and utilities installed. Inside that directory is a batch file called "setenv.bat" which sets an environment variable called THUMBDRIVE. It is set by using this command in the batch file:
639639
640640`  set THUMBDRIVE=%CD:~0,2%`
641641
642642This is used in setenv.bat to set some paths to other things I have installed on the USB drive. I also have a link in the root directory of the thumb drive with this property:
643643
644644` %SystemRoot%\system32\cmd.exe /k bin\setenv`
645645
646646so that when I click on that link when the thumb drive folder is diplayed after inserting it, it will open a command prompt at the thumb drive with the environment variables set from setenv.bat.
647647
648648Also inside the bin directory is [sed](http://sed.sf.net) (the actual binary is one I obtained from the mingw distribution). So I created another batch file called fixlaz.bat which takes one argument, the drive letter which is currently in the Lazarus/fpc settings files that you want to change (note that this is the previous drive letter the last time you ran fixlaz.bat, not the current one of your USB drive which fixlaz.bat already knows). You will need to create this batch file to fit where you installed Lazarus in the root directory structure of the drive if you didn't install it directly in the root folder, and then repeat these lines also for the editoroptions.xml and fpc.cfg files (fpc.cfg is the the fpc bin directory, which might be buried deep in the lazarus folder):
649649
650650` copy %THUMBDRIVE%\lazarus\environmentoptions.xml %THUMBDRIVE%\lazarus\environmentoptions.bak`\
651651` sed -e 's/%1/%THUMBDRIVE%/g' %THUMBDRIVE%\lazarus\environmentoptions.bak > %THUMBDRIVE%\lazarus\environmentoptions.xml`
652652
653653So to use it, I would type at the command prompt of the USB drive:
654654
655655` fixlaz G:`
656656
657657if "G:" was the previous drive letter used the last time I ran it. This will then scan the file(s) and replace "G:" with the current drive letter of the USB drive, which is in the %THUMBDRIVE% environment variable (after running setenv.bat). Note that you could write it to save the current drive letter in a separate file, so that you wouldn't have to remember it yourself the next time. But this works well enough for me right now. \>\>
658658
659659The binary package is available for Linux and Windows from
660660
661661<http://sourceforge.net/project/showfiles.php?group_id=89339>
662662
663663Download the latest release (currently Lazarus-0.9.28-0-win32.exe) and launch the application. You will be taken through a typical Windows installation, in which the FPC compiler and source libraries are installed within the same directory structure as Lazarus, and the IDE should launch and operate without significant problems, provided you have uninstalled(!!!) any previous version of Lazarus and/or FPC (often found in the C:\pp directory).
664664
665665You can also use a Lazarus Snapshot. For download locations see [[Lazarus Snapshots Downloads]].
666666
667667Tip: It's perhaps a good idea to reboot your Windows after you installed Lazarus and before you try to install additional lazarus components as zeoslib fore example.
668668
669669#### Installing from source
670670
671671If you prefer to install from sources, then follow these instructions (Thanks to Joe for the initial Step-by-step description). Please note these instructions are for SubVersion.
672672
673673You have to download the lazarus source from one of the [[Lazarus Snapshots Downloads|snapshots servers]]. Then unzip it to c:\lazarus for example \[below called \$(LazarusDir)\].
674674
675675Or you use SVN:
676676
677677` []$ svn checkout `[`http://svn.freepascal.org/svn/lazarus/trunk/`](http://svn.freepascal.org/svn/lazarus/trunk/)
678678
679679You have to install at least fpc-2.2.4, but a fpc-2.5.1 snapshot is also possible. It compiles for me, and lazarus.exe works. The path to my fpc is: c:\pp\bin\win32. In this directory you can find a lot of exe (make, grep, ppc386, and so on).
680680
681681Open a command line. Start-\>Run...\>command or choose MS-DOS icon.
682682
683683Type:
684684
685685`//Replace $(LazarusDir) with the path you have unzipped/checked out Lazarus`\
686686`cd $(LazarusDir)\ide`\
687687`set path=c:\pp\bin\win32;$(LazarusDir)  //of course change the first to`\
688688`                                        //the path of yours`\
689689`windres -i lazarus.rc -o lazarus.res`\
690690`cd $(LazarusDir)`\
691691`make`
692692
693693If you are lucky then you can type: lazarus.exe. The source editor, dialogs and the property editor work, but not perfectly... Look and you will see.
694694
695695You can compile examples also:
696696
697697`cd $(LazarusDir)\examples`\
698698`make`
699699
700-<s>If you extracted lazarus to another drive, eg.: d:\lazarus. It can happen that you need the gnu utility to make it. If you have it, you can take its path to set path=...;\<gmakepath\> but it is simpler not to choose drive d:\\</s>
700+If you extracted lazarus to another drive, eg.: d:\lazarus. It can happen that you need the gnu utility to make it. If you have it, you can take its path to set path=...;\<gmakepath\> but it is simpler not to choose drive d:\\
701701
702702That's all.
703703
704704### Installing Lazarus under FreeBSD
705705
706706#### FreeBSD 6+
707707
708708The latest version of Lazarus into FreeBSD port tree is 0.9.28.3 (Fixes branch). We can to install lazarus using FreeBSD ports.
709709
710710`[]# cd /usr/ports/editors/lazarus && make install clean clean-depends`
711711
712712If you get the messages about missing source files, go to \[menu bar \>\> Environment \>\> Environment Options \>\> Files Tab: FPC source library\] and enter the directory of the FPC source files. It can be obtained from /usr/ports/distfiles/freepascal
713713
714714### Installing Lazarus under PC-BSD 1.0rc1+
715715
716716You can install Lazarus on PB-BSD by simply downloading the Lazarus PBI from [PBI Dir](http://www.pbidir.com/)
717717
718718Note that you must install glib* port from /usr/port/devel/glib* or glib packages by pkg_add -r glib12 glib20. I will fix this in new PBI releases.
719719
720720**\[other OpenBSD/NetBSD/DragonFlyBSD goes here\]**
721721
722722### Installing Lazarus under macOS
723723
724724First need to install the Apple developer tools. Then you can install the latest release from [1](http://sourceforge.net/projects/lazarus/files/) or the daily snapshots from the [[Lazarus Snapshots Downloads|snaphot servers]].
725725
726726More elaborate instructions can be found in [[Installing Lazarus on macOS]].
727727
728728If you install all 3 .dmg snapshot files, this also installs the FPC compiler and the FPC and Lazarus source too. If you only need to run Lazarus to develop and compile your own apps, you don't need to install the FPC and Lazarus sources as described above. If you need to rebuild Lazarus or want to help with its development, then you should to install the Lazarus source to a folder where you have read-write permission, as described above.
729729
730730Now you can start Lazarus from the folder /Applications.
731731
732732### Installing Lazarus under Haiku
733733
734734Lazarus requires Qt under Haiku. Qt is not installed by default under Haiku. You need to install package available from this site : <http://qt-haiku.ru/>
735735
736736Currently, there is no binary package to install Lazarus.
737737
738738You will have to compile Lazarus from sources.
739739
740740Detailed instructions to build Lazarus under Haiku are available here : [[Installing Lazarus on Haiku]]
741741
742742### Additional experiences and advice on installing FPC and Lazarus
743743
744744On linux, getting Lazarus to work can be complicated if you have an older version installed. If you have already installed earlier versions of FPC and/or Lazarus, you have to take great care that the PATHS are adjusted so that only your new versions are called.
745745
746746Pitfalls that I have experienced in various attempts with SuSE linux include:
747747
748748The rpm versions often install FPC in /bin or /usr/bin, with the libraries in /lib or /usr/lib.
749749
750750If you perform a make install on a source version or use a .tar.gz, the compiler is usually installed in /usr/local/bin with the libraries in /usr/local/lib.
751751
752752So if earlier versions have been installed from rpm, make sure all links are changed to reflect the directory structure of your new compiler. The place to make the changes is in /etc/fpc.cfg ; make sure there are no remnant configuration files in your home directory or in your FPC download directory. Typically they are found in ~/.fpc.cfg
753753
754754Make sure the links in /etc/fpc.cfg point to the correct versions of the libraries (particularly if you have older versions still lurking around).
755755
756756In /usr/local/bin or /usr/bin there is a file called fpc ; this is the executable that is called when you invoke the compiler. One of the first things it does is to open ppc386 in the same directory. This has to be the same version as the fpc file, or can be a link pointing to the true ppc386 in some other directory (such as a library directory, or the fpc directory in your own development space); be sure to update your link if you install a newer version of the compiler.
757757
758758Try running the compiler from the command line using one of the simple example programs or one which you wrote yourself.
759759
760760Turning to Lazarus:
761761
762762If you use a downloaded snapshot (.tar.gz) or get the source from CVS, enter your lazarus directory and type
763763
764764`make`\
765765`./lazarus `
766766
767767and hopefully the IDE should load. There may be a message saying it can't find the sources; if so, go to the menu at the top and select Environment -\> Environment options and insert the name of the directory where you expect to find your lazarus files (eg ~/FreePascal/lazarus), your compiler (e.g. /usr/local/bin/ppc386), the FreePascal source directory (e.g. /usr/local/lib/fpc/\$version/fpc or a directory in your own space e.g. ~/FreePascal/fpc). Then close the dialog and start programming.
768768
769769You may find further problems when you start programming or compiling; most of these will be related to PATH selection.
770770
771771Many of the difficulties are dealt with in the Lazarus FAQ, found either on this WiKi site, or a more complete list on the main Lazarus site
772772
773773<http://www.lazarus.freepascal.org/modules.php?op=modload&name=FAQ&file=index>
774774
775775From the top menu select Run -\> Compiler Options (or Project -\> Compiler Options in more recent releases of Lazarus) and select the Paths tab on the resulting dialog. There are several boxes for entry of paths for Unit files, Include files, Other source files, Libraries etc. For each of these, it is worth pressing the ... (ellipsis) button on the right, and you will be given a blank window for inserting path information, and a lower window giving some suggestions. Select as many as you like (or ALL!) and press the ADD button to transfer the selections to the upper window. When your selection is complete, press OK and move on to the next box. If you know of other paths which need to be followed, press the Browse button associated with each box, and insert the additional paths.
776776
777777When you think you have got your paths right, try to compile your application. If there are further path-related errors ('can't find unit .......') then go back and check your paths, both in /etc/fpc.cfg and in your Run -\> Compiler Options dialog (or Project -\> Compiler Options depending on your version).
778778
779779Once you have got the environment and PATHS correct, it is worth saving the settings to a file, otherwise you will have to go through this process for each new project. In the Run -\> Compiler options dialog there is a Load/Save button; select this and then save the setings to the filename of your choice: mine is ~/FreePascal/default.cfg. Then each time I start a new project, I can go to the Run -\> Compiler Options dialog (or Project -\> Compiler Options), select Load/Save, and load my default.cfg file to the new project. You can, of course, modify the options for each new project if you so desire.
780780
781781---
782782*From the Free Pascal wiki, page "Installation hints for old versions", as it stood on 2022-01-13 after a change by Trev, out of the wiki's dump of 2024-05-26. 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).*
783783Category: Historical
784784Category: Install
785785Category: Lazarus

Back to history