L2CPBG

HowTos »

Synology Containerization » History » Revision 6

Revision 5 (Jörg Ebeling, 03/31/2025 10:41 PM) → Revision 6/7 (Jörg Ebeling, 03/31/2025 10:46 PM)

# 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, Manager 
   - ✅ Text Editor Editor<br> 
   <img style="border: 2px solid grey;" src="1_prerequist.png"/> 


 ## Installation 

 ### 1. Prepare Files 

 1. Upload `l2cpbg-docker.zip` to `/docker` in "File Station" 
    <img style="border: 2px solid grey;" src="2_upload.png"/> 
 2. Right-click `l2cpbg-docker.zip` → "Extract Here" (creates `/docker/l2cpbg` subfolder) 


 
 ``` 

 ### 2. Configure Settings 

 
 ``` 
 3. Open `/docker/l2cpbg/l2cpbg.conf` in "Text editor" 
      <img style="border: 2px solid grey;" src="3_edit-config.png"/> 

 
 4. **IMPORTANT:** IMPORTANT: Set encoding to UTF-8 
      <img style="border: 2px solid grey;" src="4_utf8-encoding.png"/> 


 UTF-8: File → Encoding → Unicode (UTF-8) 
 ``` 

 #### 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"/> 
 <img style="border: 2px solid grey;" src="6_dav.png"/> 

 ⚠️ **Do NOT modify:** 
 - `[ldap] port`  
 - `[db] directory` 

 ### 3. Deploy Container 
 ``` 
 5. Open Container Manager → Project → Create 
 6. Set path to `/docker/l2cpbg` 
 7. Select "Use existing docker-compose..." 
 8. 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