lazarus-docker

Provides a docker file with built FPC and Lazarus sources from Github.

This docker file builds FreePascal and Lazarus from their sources. Freepascal 3.2.2 is compiled from Git tag 3.2.2 for Linux 64-bit, Windows 32 and 64-bit (cross compilation). Lazarus (lazbuild) is compiled from Git main branch also for Linux 64-bit, Windows 32 and 64-bit.

• FreePascal 3.2.2
• Lazarus main branch

The dockerfile is available from https://hub.docker.com/repository/docker/wimmercg/lazarus-docker

Using the image

You can run the image from your project path and compile your project by mounting the project path into the container. To do so, create runenv.sh as shown below into your project folder, so it can be executed in the following way (within your project's path)

docker run -v $PWD:/project wimmercg/lazarus-docker:1.2.0 /project/runenv.sh

This docker command directly starts the lazarus-docker image, mounts the current working directory ($PWD) into the docker container as path /project, and executes the script runenv.sh from your current working directory.

Using the image from a Dockerfile

You can use the image as a starting point for your dockerfile. In this example we include runenv.sh into the new image file.

FROM wimmercg/lazarus-docker:1.0.3
RUN mkdir /build
RUN mkdir /project && git clone https://example.com/project
COPY runenv.sh /runenv.sh
RUN chmod 777 /runenv.sh
CMD /runenv.sh

For example you can use lazbuild for all OS targets. These are convenient scripts to build.

• lazbuildl64 for Linux 64bit
• lazbuildw32 for Windows 32bit
• lazbuildw64 for Windows 64bit

runenv.sh

#!/bin/bash
cd /project
git pull  #update sources since image build
lazbuildl64 myproject.lpr && mkdir -p /build/linux64/ && mv myproject /build/linux64/
lazbuildw32 myproject.lpr && mkdir -p /build/win32/ && mv myproject.exe /build/win32/
lazbuildw64 myproject.lpr && mkdir -p /build/win64/ && mv myproject.exe /build/win64/

Access build directory

You can run your image, compile your project and receive all your built files with this chain of commands:

rm -rf ./dest_build
docker run --name <your_docker_container_name> <your_image>
docker cp <your_docker_container_name>:/build ./dest_build
docker container rm <your_docker_container_name>

Adding packages

You can add packages that are used by your project in the following way. Third party packages need to be downloaded first.

Packages of the Lazarus Online Package Manager can be downloaded from https://packages.lazarus-ide.org You do not need to call lazbuild --build-ide= because the IDE is not used.

# Third party
cd $LAZARUSDIR && ./lazbuild --add-package ../../lnet/lazaruspackage/lnetvisual.lpk --primary-config-path=$LAZARUSDIR --lazarusdir=$LAZARUSDIR

# Standard components
cd $LAZARUSDIR && ./lazbuild --add-package components/opengl/lazopenglcontext.lpk --primary-config-path=$LAZARUSDIR --lazarusdir=$LAZARUSDIR

cd $LAZARUSDIR && ./lazbuild --add-package components/tachart/tachartlazaruspkg.lpk --primary-config-path=$LAZARUSDIR --lazarusdir=$LAZARUSDIR

Dockerfile example

RUN wget https://packages.lazarus-ide.org/LNet.zip && unzip LNet.zip && rm LNet.zip && \
     cd $LAZARUSDIR && ./lazbuild --add-package ../../lnet/lazaruspackage/lnetvisual.lpk --primary-config-path=$LAZARUSDIR --lazarusdir=$LAZARUSDIR && \
     cd $LAZARUSDIR && ./lazbuild --add-package components/opengl/lazopenglcontext.lpk --primary-config-path=$LAZARUSDIR --lazarusdir=$LAZARUSDIR && \
     cd $LAZARUSDIR && ./lazbuild --add-package components/tachart/tachartlazaruspkg.lpk --primary-config-path=$LAZARUSDIR --lazarusdir=$LAZARUSDIR

lazbuild commands

$LAZARUSDIR/lazbuild --os=win64 --cpu=x86_64 --primary-config-path=$LAZARUSDIR --lazarusdir=$LAZARUSDIR <lpr file>
$LAZARUSDIR/lazbuild --os=win32 --cpu=i386 --primary-config-path=$LAZARUSDIR --lazarusdir=$LAZARUSDIR <lpr file>
$LAZARUSDIR/lazbuild --os=linux --cpu=x86_64 --primary-config-path=$LAZARUSDIR --lazarusdir=$LAZARUSDIR <lpr file>

Run the image with terminal

In this way you can tryout the image in a termminal first.

docker run -it lazarus-base /bin/bash
yarn it
npm run it

Building the image

You can use one of the following commands to build the image:

A package.json is provided for npm or yarn for your convenience

docker build . -t lazarus-base
yarn make
npm run make

LNET package (network package)

By default LNET will not be installed anymore. Instead you must install your own LNET version or call

• /install_corpsman_lnet.sh - Installs Corpsman's version of LNET. See his gihub repository.
• /install_original_lnet.sh - Install official version of LNET.

Changes

• 1.0.x
  • Using debian:stretch-20211220-slim
• 1.1.0
  • Using debian:11.6-slim
  • The LNET package has been removed from being installed by default. Instead an user of this image must call either the script /install_corpsman_lnet.sh or /install_original_lnet.sh to install different versions on her own. Corpsman version has some fixes that are not available in the default version, mainly NO_DELAY for TCP is enabled (improves performance).
• 1.2.0
  • Using debian:12-slim
  • Made standard as latest-tag for image on docker hub.

Documentation

• https://www.freepascal.org/
• https://wiki.freepascal.org/lazbuild
• https://www.getlazarus.org/setup/making/
• https://packages.lazarus-ide.org
• https://wiki.freepascal.org/Cross_compiling_for_Windows_under_Linux
• https://github.com/fpc/FPCSource
• https://github.com/fpc/Lazarus