Download and install Lazarus release version
Binary releases for various platforms are available via the Lazarus Sourceforge download area.
For people who are blocked by SF, the Lazarus releases from sourceforge are mirrored at:
- and later at (after some time for syncronization) http://michael-ep3.physik.uni-halle.de/Lazarus/releases/
- and http://mirrors.iwi.me/lazarus/
Specific for platform
Get Lazarus for Windows - use the Sourceforge link above.
TortoiseSVN Client is for Windows only. You may download it from http://tortoisesvn.tigris.org/.
This page demonstrates how to download and update Lazarus SVN source, but it can be used for FPC source in the same way.
A SVN command line client is available from the official SVN website for many platforms.
On Linux, it is recommended to install subversion using the package management system offered by your distribution. For example:
sudo apt-get install subversion
Getting Lazarus SVN development version
Using the command line
To get Lazarus for the first time:
Open a terminal/command prompt, change to the directory you wish the Lazarus folder to be created in and type:
svn co http://svn.freepascal.org/svn/lazarus/trunk lazarus
To update Lazarus sources:
Open a terminal/command prompt, change to the lazarus directory and type:
For compiling see here.
Sometimes the URL of repository given above does not work, because between the svn server there is a http-proxy server. That server usually claims to be a 'transparent' proxy, but still doesn't pass your svn commands correctly to the svn.freepascal.org server.
The svn.freepascal.org server also listens on port 8080. Maybe the proxy doesn't interfere with http trafic on that port, so you can try:
svn co http://svn.freepascal.org:8080/svn/lazarus/trunk lazarus
The Lazarus svn repostory is mirrored on sourceforge with a delay of 3 minutes using svnsync. The sourceforge repository uses the https protocol. Proxy servers usually don't interfere with that protocol. You can check out form sourceforge using the following command
svn co https://lazarus.svn.sourceforge.net/svnroot/lazarus/trunk lazarus
The FPC and Lazarus svn repostories are also mirrored to svn2.freepascal.org. You can check out from svn2.freepascal.org with
svn co http://svn2.freepascal.org/svn/lazarus/trunk lazarus
If you own the proxy server, or are friends with the person who does, there are details of setting up a proxy to pass svn commands here: http://subversion.tigris.org/faq.html#proxy This contains an example for squid. Remember to set up the client to use the proxy ! (For TortoiseSVN, see settings/network).
There are scripts for Windows and Linux to automate downloading and building Lazarus: Scripts for Lazarus
There is also a tool built with FPC/Lazarus that does this for you; see fpcup
Compiling and running Lazarus
Using the command-line
Lazarus is shipped with Makefile for gnu "make" utility.
The tool allows you to compile Lazarus from command-line easily. You need to have fpc and fpc-packages installed and configured first.
To compile go to Lazarus directory in your terminal and type
This should rebuild LCL and Lazarus IDE with basic packages installed. Another useful command is
which adds the same packages that the release version has.
Then you can run Lazarus from the same source directory with command "lazarus" (in Unix systems "./lazarus"). If the plan is to run many versions, you can use different configuration directories with --pcp option, thus "lazarus --pcp=configdir".
To see a list of available targets for make type make help. Note: "make help" exists since 1.0. Here is the output of "make help":
Main targets Without any target, target 'all' will be invoked. all build minimal IDE, lazbuild, startlazarus. clean deletes files that 'all' creates lazbuild build lazbuild and lcl with nogui widgetset bigide as all, except that the IDE is built with a lot of extra packages useride calls lazbuild to build an IDE with your active profile, requires lazbuild Sub targets registration build package FCL lazutils build package LazUtils, requires registration codetools build package CodeTools, requires lazutils lcl build package LCL, requires lazutils tools build lazres, svn2revisioninc, updatepofiles, lrstolfm, requires LCL with nogui widgetset ideintf build package IDEIntf, requires lcl basecomponents build synedit and lazcontrols for the LCL_PLATFORM, requires ideintf bigidecomponents build many extra packages for the LCL_PLATFORM, requires basecomponents starter build startlazarus, requires basecomponents examples build basic examples, requires basecomponents Note: There are more examples having their own directory Usage examples: Updating svn and build a minimal IDE, startlazarus and lazbuild: make clean svn up make clean all Note: You can start lazarus with 'startlazarus' Note: Use the IDE or lazbuild to compile your projects/packages. Updating svn and build an IDE with your last set of packages: make clean svn up make clean lazbuild useride Clean up: There is no command to clean up a svn repository completely, but you can use the following command under Linux/OS X: svn status | grep '\?' | sed -e 's/\? *//' | xargs rm -r
There're also additional parameters, can be used for 'making' Lazarus.
the %compiler_switches is passed to each fpc call. The option is useful for specifying defines
make bigide OPT="-dNoGdkPixBufLib -gw2"
makes LCL and ide with NoGdkPixBufLib defined and dwarf2 debug info.
%platform is the target widgetset. It can be win32,wince,gtk,gtk2,qt,carbon,cocoa,customdrawn.
Rebuilds LCL and IDE for gtk2 widgetset
%compiler_path is the path to a custom compiler binary you want to build the target with.
Getting FPC SVN development version
Here are some hints how to get and install the development version of FPC (at the moment 3.1.1), which contains new features, bug fixes but is less stable and contains new bugs. The compiler is not included in the Lazarus SVN, but has its own FPC SVN. You must install first the latest released FPC. Download it from here http://sourceforge.net/projects/freepascal/ and install, or see more details here: Installing the Free Pascal Compiler.
Then create a directory and download FPC from SVN:
mkdir -p ~/freepascal cd ~/freepascal svn co http://svn.freepascal.org/svn/fpc/trunk fpc
This will take some time.
You can also use TortoiseSVN client on Windows as explained earlier.
Compiling and installing FPC
There are many ways to compile and install FPC.
- Use plain make.
- Build a FPC package for your Linux distribution (.deb or .rpm file). The package allows to easily uninstall, upgrade and downgrade FPC and makes sure that all files are installed at the common places. So if something goes wrong, other users know how to help you.
In either case Lazarus must finally be configured for the new FPC.
Building and installing Free Pascal in UNIXe
The following instructions work in UNIX platforms, such as Linux, but also Mac OS X.
Building Free Pascal from source code can be useful in a number of situations. One example is when debugging a problem in the compiler, in the RTL or in the FCL. The distributed FPC installs come without debug info, but the install created from the makefiles constains debug info by default. Another use is testing the development version of the compiler, although often there are also snapshots available for that.
Step 1 - Make sure you have a compatible starting compiler installed.
Usually this will mean having installed the latest stable release.
Step 2 - Download the source of the new compiler
The first thing to do is downloading the Free Pascal source code for the version you desire to build. For example, to download the latest fixes 2.4 branch do:
svn checkout http://svn.freepascal.org/svn/fpc/branches/fixes_2_4 fpcfixes2_4
Step 3 - Build the compiler
Now enter the newly created directory and build and install Free Pascal:
cd fpcfixes2_4 make clean all install INSTALL_PREFIX=~
This will compile the compiler in 3 cycles, first using the already installed compiler and then using the newly compiled compiler.
It install all needed files in the specified directory. You can install to any other directory if needed. You just have to use the root account if the directory does not allow writing with your normal user account.
Step 4 - Update your fpc.cfg file
Then create a file
It is a hidden file (note the first dot). Enter the following contents to the file. If you installed to another directory, use that instead of your home dir.
#include /etc/fpc.cfg -Fu~/lib/fpc/$fpcversion/units/$fpctarget -Fu~/lib/fpc/$fpcversion/units/$fpctarget/* -Fu~/lib/fpc/$fpcversion/units/$fpctarget/rtl
This allows installing any future fpc versions into PREFIX=~ without touching that config file.
To run fpc, ~/bin must be in PATH environment variable. Usually it is there by default. You also must add path ~/lib/fpc/2.7.1 to PATH because the actual compiler binary is located there. Most Linux systems now use bash shell and this configuration can be added to ~/.bashrc (a hidden file again) :
Note that path separator is ":" under Linux (";" under Windows). Now see "Configure Lazarus for the new fpc" below for the next step.
Build a debian/ubuntu package
Important: This script does not create the official debian/ubuntu packages. It creates a fpc package that contains the compiler and all packages.
To build the package you need to install some packages:
sudo apt-get install libgpmg1-dev fakeroot libncurses5-dev build-essential
Go into your lazarus source directory. The directory must be writable.
cd ~/freepascal/lazarus/tools/install ./create_fpc_deb.sh fpc ~/freepascal/fpc
If you get an error about a missing file or tool you may have to install a missing package. If you get a compilation error your installed fpc is not the released compiler or you were unlucky and fetched a fpc svn reversion that contains a bug. Search help on the mailing list, forum or chat. If it ran through you now have a deb file, which you can install:
sudo dpkg -i fpc_2.5.1-091121_i386.deb
The file name is different for you.
Build a RPM package
Configure Lazarus for the new FPC
Now fpc is installed either by "make install" or by using a distro specific package. The next step is to compile lazarus svn with the new compiler and tell the IDE to use the directory /home/username/freepascal/fpc as FPC source directory.
If you have not yet downloaded the lazarus svn, do it now: Development versions from SVN. For example:
cd ~/freepascal svn co http://svn.freepascal.org/FPC/svn/lazarus/trunk lazarus
This will take some time, continue with:
cd ~/freepascal/lazarus make clean all
If this gives linker errors, you have to install some packages (build-essential, libgtk2.0-dev,libgdk-pixbuf-dev). Start the IDE:
cd ~/freepascal/lazarus ./lazarus
This is a minimal IDE without any extra packages. Now the IDE must be setup and can be built with packages:
- Go to Tools -> Options -> Environment
- Set lazarus directory to /home/username/freepascal/lazarus
- Set FPC source directory to /home/username/freepascal/fpc
- Click Ok to close the dialog
- Tools -> Configure Build Lazarus
- Click Build.
- Restart the IDE
- Now you have the latest and greatest IDE built with the latest and greatest FPC.
Development versions from Git
There is a Git mirror of the official SubVersion repository being maintained on GitHub. This mirror gets sync'ed every 15 minutes with the SubVersion repository. For more information on getting Git and cloning the Lazarus repository, follow this link: Git Mirrors. You can also use git directly with SubVersion server using git-svn link. See Lazarus git-svn for details.
Browse the Source Repository with a Web Browser
The contents of the SVN archive can also be browsed with your web-browser through this viewcvs interface.
There are some unofficial sites where you can find Lazarus and Free Pascal too:
- FreeSparta is a commercial distribution of Lazarus for Windows.
- You can get a Ubuntu LiveCD from Austrian University of Applied Sciences hosting http://www.sigma-server.com/liveCD/Ubuntu-7.10-NTC-Lazarus.iso and md5sum file is here http://www.sigma-server.com/liveCD/Ubuntu-7.10-NTC-Lazarus.iso.md5.
- The CodeTyphon distribution bundles Lazarus with additional packages and components.
- LiteZarus is a Lazarus distro intended for designing creating non-LCL projects.
- Lazarus is available on CDs and USB sticks from the Blaise Pascal Magazine store.