Project

General

Profile

Synology Containerization » History » Revision 2

Revision 1 (Jörg Ebeling, 03/31/2025 09:11 PM) → Revision 2/7 (Jörg Ebeling, 03/31/2025 09:59 PM)

# Synology Containerization Guide for L2CPBG 

 ## Prerequisites 
 - Prerequist 

 A Synology NAS with **Container Manager** support container support. 

 For this instruction you need to have the following Synology packets installed: 
 - Required packages: 
   - ✅ Container Manager 
   
 -  Text Editor 
 - [l2cpbg-docker.zip](https://projects.shbe.net/l2cpbg/l2cpbg-docker.zip) will always load the newest L2CPBG version during build 

 ## Installation 

 ### 1. Prepare Files 
 ``` 
 1. Upload `l2cpbg-docker.zip` Open "File Station" and copy [l2cpbg-docker.zip]() to your `/docker` in "File Station" directory 
 2. Right-click `l2cpbg-docker.zip` → on l2cpbg-docker.zip and "Extract Here" (creates `/docker/l2cpbg` (files are zipped within a "l2cpbg" subfolder) 
 ``` 

 ### 2. Configure Settings 
 ``` 
 3. Open `/docker/l2cpbg/l2cpbg.conf` in "Text editor" Change into extracted "l2cpbg" subfolder and edit `l2cpbg.conf` 
 4. IMPORTANT: Set Whenever you edit `l2cpbg.conf` with an Editor, take attention that your encoding is set to UTF-8: File → Encoding → Unicode (UTF-8) UTF-8! 
 ``` 

 #### Key Configuration: 

 ```toml 
 5. Now change the [ldap] 
   # Change "example" and "com" `base` to your company, family or whatever name. 
    This can become anything you like, 
   # but take attention to use only alphanumeric characters. 
    Also write it down, you need to use alphanumeric characters 
   base        = "dc=example, dc=com"  

 the same one within your phone configuration. 
    Do the same with [ldap.bind] 
   dn     = "cn=phone"        # Change "phone" `dn` and `pass` which is likewise the login-name and password to your preferred L2CPBG's internal LDAP username 
   pass = "your-password" # LDAP password 

 server. 
 6. Within the [dav] 
   block, change `server`, `user` and `pass` to your CardDAV's 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" 

 URL, login and password. 
 7. At last, adapt the [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 block to be written as "string") 

   maxarealength = 7      # Longest possible length of a telephone number within your local area location specific settings 
 ``` 

 ⚠️ **Do NOT modify:** 8. For sure, your can also adapt other settings here to your needs, but do **not** change the [ldap] port nor [db] directory! 
 - `[ldap] port`  
 - `[db] directory` 

 ### 3. Deploy Container 9. Once finished editing, select menu File -> Save and close the "Text Editor" 
 ``` 
 5. Open Container Manager → 10. Start "Container Manager", on the left side go to Project → Create 
 6. Set and "Create" a new project. 
    "Set Path" to the path to `/docker/l2cpbg` 
 7. of the extracted l2cpbg-docker.zip `/docker/l2cpbg`. 
    Select "Use existing docker-compose..." when asked. 
 8. Skip 11. Click "Next", do not "Set up web portal setup → Next → Enable auto-start → Done ...", again "Next", enable "Start the project ..." and finally press "Done" 
 ``` 

 ### 4. Verification 
 - Successful 12. Now you should see a windows where the container components get downloaded and build shows: together, which might take 1-2 minutes. 
     If everything went well, the last line should be `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 
 0`. If not, check the build log what happen.