Deployment¶

Deploying the Linux ACL Management System can done via various ways. This ranges for options prioritizing security while others prefer fast pace deployment.

Deploying via Source Code¶

This method is the most secure and manual way of deploying Linux ACL Management System. It is recommended for institutions deploying it in an isolated environment without internet connection by building the binaries on-site where it is intended to deploy.

1. Install the Source Code Tarball¶

To install the tarball, visit the official repository and follow the instructions.

Copy the following commands to install it via command line. Make sure you have curl installed on the system.

Linux AMD64 Architecture¶

curl -L -o laclm.tar.gz https://github.com/PythonHacker24/linux-acl-management-backend/raw/refs/heads/development-v1/build/laclm-linux-amd64-source.tar.gz

Linux ARM64 Architecture¶

curl -L -o laclm.tar.gz https://github.com/PythonHacker24/linux-acl-management-backend/raw/refs/heads/development-v1/build/laclm-linux-arm64-source.tar.gz

You may now ship the tarball to any system with no internet connection and you will be able to build from the source code there provided that you have proper build tools installed on the target machine.

2. Extract the Source Code Tarball¶

Extract source code from tarball with following command. Make sure you have tar installed on the system.

tar -xzf laclm.tar.gz

This will create a folder in your current directory. cd into that folder.

3. Build Locally¶

You can build the binary with the following command:

make build-offline

This will build the binary and store it at /bin.

4. Configure¶

With the source code, you get config.yaml which you can configure with. For more information related to configuration, refer here.

5. Deploy¶

For deploying the backend, execute the binary with config.yaml

./laclm --config <path_to_config>

Deploying via Prebuilt Binaries¶

You can install prebuilt libraries from offical GitHub repository.

Copy the following commands to install it via command line. Make sure you have curl installed on the system.

1. Download the Binary¶

Linux AMD64 Architecture¶

curl -L -o laclm https://github.com/PythonHacker24/linux-acl-management-backend/raw/refs/heads/development-v1/bin/laclm-linux-amd64

Linux ARM64 Architecture¶

curl -L -o laclm https://github.com/PythonHacker24/linux-acl-management-backend/raw/refs/heads/development-v1/bin/laclm-linux-amd64

2. Configure¶

With the source code, you get config.yaml which you can configure with. For more information related to configuration, refer here.

3. Deploy¶

For deploying the backend, execute the binary with config.yaml

./laclm --config <path_to_config>

Deploying via Docker Ecosystem¶

1. Get the Source Code¶

git clone https://github.com/PythonHacker24/linux-acl-management-backend

2. Build Image¶

docker build -t laclm .

3. Run Docker Image¶

docker run --rm laclm

For development purposes, use Docker Compose to run a test LDAP server (OpenLDAP) and PHPLDAPAdmin.

docker-compose up --build