L2CPBG

# Synology Containerization Guide for L2CPBG

## Prerequisites

- Synology NAS with **Container Manager** support

- [l2cpbg-docker.zip](https://projects.shbe.net/l2cpbg/l2cpbg-docker.zip) will always load the newest L2CPBG version during build

- Required Synology Apps: Container Manager, Text Editor

  <img style="border: 2px solid grey;" src="1_prerequist.png"/>

## Installation

### 1. Prepare Files

- Upload `l2cpbg-docker.zip` to `/docker` in "File Station"

   <img style="border: 2px solid grey;" src="2_upload.png"/>

- Right-click `l2cpbg-docker.zip` → "Extract Here" (creates `/docker/l2cpbg` subfolder)

### 2. Configure Settings

- Open `/docker/l2cpbg/l2cpbg.conf` in "Text editor"

     <img style="border: 2px solid grey;" src="3_edit-config.png"/>

- **IMPORTANT:** Set encoding to UTF-8

     <img style="border: 2px solid grey;" src="4_utf8-encoding.png"/>

#### Key Configuration:

```toml

[ldap]

  # Change "example" and "com" to whatever you like,

  # but only use alphanumeric characters

  base      = "dc=example, dc=com" 

[ldap.bind]

  dn   = "cn=phone"      # Change "phone" to your preferred LDAP username

  pass = "your-password" # LDAP password

[dav]

  server       = "https://cloudserver.example.com/remote.php/dav" # Users personal CardDav URL should be detected from server

  user         = "cloud-login-name"

  pass         = "cloud-login-password"

[location]

  country       = "DE"

  int           = 49   # Your international dial code. 1 = US, 49 = Germany, ...

  area          = 30   # Your local area code (without a leading 0), like 30 = Berlin

  areaPrefix    = "0"  # Dial prefix for national calls (has to be written as "string")

  maxarealength = 7    # Longest possible length of a telephone number within your local area

```

<img style="border: 2px solid grey;" src="5_ldap-base.png"/><br>

<img style="border: 2px solid grey;" src="6_dav.png"/><br>

<img style="border: 2px solid grey;" src="7_location.png"/>

⚠️ **Do NOT modify:**

- `[ldap] port` 

- `[db] directory`

### 3. Deploy Container

- Open Container Manager → Project → Create

- Set path to `/docker/l2cpbg`

- Select "Use existing docker-compose..."

<img style="border: 2px solid grey;" src="8_create-project.png"/>

- Skip web portal setup → Next → Enable auto-start → Done

### 4. Verification

- Successful build shows: `Exit Code: 0`

- Check logs if errors occur

## Pro Tips

- 🔄 **Reconfiguration:** Edit `/docker/l2cpbg/l2cpbg.conf` → Container Manager: Project → right-click l2cpbg → Restart

- 🐛 **Debugging:** Check Container Manager logs