Project

General

Profile

Synology Containerization » History » Version 2

Jörg Ebeling, 03/31/2025 09:59 PM

1 2 Jörg Ebeling
# Synology Containerization Guide for L2CPBG
2 1 Jörg Ebeling
3 2 Jörg Ebeling
## Prerequisites
4
- Synology NAS with **Container Manager** support
5
- Required packages:
6
  - ✅ Container Manager
7
  - ✅ Text Editor
8
- [l2cpbg-docker.zip](https://projects.shbe.net/l2cpbg/l2cpbg-docker.zip) will always load the newest L2CPBG version during build
9 1 Jörg Ebeling
10 2 Jörg Ebeling
## Installation
11 1 Jörg Ebeling
12 2 Jörg Ebeling
### 1. Prepare Files
13
```
14
1. Upload `l2cpbg-docker.zip` to `/docker` in "File Station"
15
2. Right-click `l2cpbg-docker.zip` → "Extract Here" (creates `/docker/l2cpbg` subfolder)
16
```
17 1 Jörg Ebeling
18 2 Jörg Ebeling
### 2. Configure Settings
19
```
20
3. Open `/docker/l2cpbg/l2cpbg.conf` in "Text editor"
21
4. IMPORTANT: Set encoding to UTF-8: File → Encoding → Unicode (UTF-8)
22
```
23 1 Jörg Ebeling
24 2 Jörg Ebeling
#### Key Configuration:
25
26
```toml
27
[ldap]
28
  # Change "example" and "com" to whatever you like,
29
  # but only use alphanumeric characters
30
  base      = "dc=example, dc=com" 
31
32
[ldap.bind]
33
  dn   = "cn=phone"      # Change "phone" to your preferred LDAP username
34
  pass = "your-password" # LDAP password
35
36
[dav]
37
  server       = "https://cloudserver.example.com/remote.php/dav" # Users personal CardDav URL should be detected from server
38
  user         = "cloud-login-name"
39
  pass         = "cloud-login-password"
40
41
[location]
42
  country       = "DE"
43
  int           = 49   # Your international dial code. 1 = US, 49 = Germany, ...
44
  area          = 30   # Your local area code (without a leading 0), like 30 = Berlin
45
  areaPrefix    = "0"  # Dial prefix for national calls (has to be written as "string")
46
47
  maxarealength = 7    # Longest possible length of a telephone number within your local area
48
```
49
50
⚠️ **Do NOT modify:**
51
- `[ldap] port` 
52
- `[db] directory`
53
54
### 3. Deploy Container
55
```
56
5. Open Container Manager → Project → Create
57
6. Set path to `/docker/l2cpbg`
58
7. Select "Use existing docker-compose..."
59
8. Skip web portal setup → Next → Enable auto-start → Done
60
```
61
62
### 4. Verification
63
- Successful build shows: `Exit Code: 0`
64
- Check logs if errors occur
65
66
## Pro Tips
67
- 🔄 **Reconfiguration:** Edit `/docker/l2cpbg/l2cpbg.conf` → Container Manager: Project → right-click l2cpbg → Restart
68
- 🐛 **Debugging:** Check Container Manager logs