[GH-ISSUE #3245] offlineIMAP migration configfile configuration and generation #1814

Open
opened 2026-02-27 11:19:16 +03:00 by kerem · 7 comments
Owner

Originally created by @olaf7 on GitHub (May 2, 2024).
Original GitHub issue: https://github.com/modoboa/modoboa/issues/3245

Manual installation (not using installer) on Debian Stable.
In any v2 version the IMAPmigration lacks the possibility to configure what needs to be configured for migration resulting in the creation of a near empty .offlineimparc file which in turn errors the migration process.

I am going to add some screenshots v1 panel and v2 panel and comment below.

image

image

image

image

Problems:

  • no option to define host, port, domain, credentials (or other required or optional settings)
  • mismatch between v1 and v2 panel settings (but this is the case in lots of settings in my instance). Here: enable imapsync, create folders
  • when changing and saving the setting to make imapsync active (enable) the change in v2 is not applied when checking the next time Iogin and check the setting

Resulting .offlineimaprc :
[general] accounts =

Originally created by @olaf7 on GitHub (May 2, 2024). Original GitHub issue: https://github.com/modoboa/modoboa/issues/3245 Manual installation (not using installer) on Debian Stable. In any v2 version the IMAPmigration lacks the possibility to configure what needs to be configured for migration resulting in the creation of a near empty .offlineimparc file which in turn errors the migration process. I am going to add some screenshots v1 panel and v2 panel and comment below. ![image](https://github.com/modoboa/modoboa/assets/835414/f56317de-891b-4d1a-8b43-de14a6e57441) ![image](https://github.com/modoboa/modoboa/assets/835414/bd3d27ac-d69d-4b9d-8cc9-ae012ec999a6) ![image](https://github.com/modoboa/modoboa/assets/835414/3e08ffd2-5128-426c-9acc-f3ffad83e0fa) ![image](https://github.com/modoboa/modoboa/assets/835414/529e1d9a-bfa0-4689-9053-d28f112dbf94) Problems: - no option to define host, port, domain, credentials (or other required or optional settings) - mismatch between v1 and v2 panel settings (but this is the case in lots of settings in my instance). Here: enable imapsync, create folders - when changing and saving the setting to make imapsync active (enable) the change in v2 is not applied when checking the next time Iogin and check the setting Resulting .offlineimaprc : ` [general] accounts = `
Author
Owner

@tonioo commented on GitHub (May 14, 2024):

@olaf7 The synchronization issue is pretty strange and I don't reproduce it...
About offlineimap settings, once you have enabled the feature, you need to create at least one provider (gmail.com for example) where you'll be able to fill-in connection parameters and more.

<!-- gh-comment-id:2110165213 --> @tonioo commented on GitHub (May 14, 2024): @olaf7 The synchronization issue is pretty strange and I don't reproduce it... About offlineimap settings, once you have enabled the feature, you need to create at least one provider (gmail.com for example) where you'll be able to fill-in connection parameters and more.
Author
Owner

@olaf7 commented on GitHub (May 14, 2024):

As in editing the almost empty config file provided by hand to suit my needs? Or will I be able to edit and or select anything from Modoboa/GUI once the config file is provided with a provider? A webform to supply details/parameters would be nice as now the configfile is not much more than a placeholder/marker.
As you can see my generated config file is far off from the template as provided by https://github.com/modoboa/modoboa/blob/master/modoboa/imap_migration/templates/imap_migration/offlineimap.conf

<!-- gh-comment-id:2110773950 --> @olaf7 commented on GitHub (May 14, 2024): As in editing the almost empty config file provided by hand to suit my needs? Or will I be able to edit and or select anything from Modoboa/GUI once the config file is provided with a provider? A webform to supply details/parameters would be nice as now the configfile is not much more than a placeholder/marker. As you can see my generated config file is far off from the template as provided by https://github.com/modoboa/modoboa/blob/master/modoboa/imap_migration/templates/imap_migration/offlineimap.conf
Author
Owner

@tonioo commented on GitHub (May 16, 2024):

Have you defined a provider and a migration yet?

<!-- gh-comment-id:2114394080 --> @tonioo commented on GitHub (May 16, 2024): Have you defined a provider and a migration yet?
Author
Owner

@olaf7 commented on GitHub (May 16, 2024):

Please note: effectively this issue should be split into two issues imho. My bad. 1. mismatch settings v1/v2 and 2. IMAP migration
Also: can you comment on how I can help debug this as clearly something is wrong (as can be seen by screenshots), but you cannot reproduce.

To answer your question regarding the imap_sync issue: I created a .offlineimaprc based on the template, but it fails for a couple of reasons:

  1. IIRC no domain and accounts should be created in advance. There is no existing domain, so no domain admin. Therefor I need to use Modoboa Administrator. This user has no postbox, so no Dovecot login, so offlineimap fails.
  2. You do not know upfront what the remote IMAP server type is and what configuration is supported / what tweaking is required. Obviously I know what the server is in my case, but in general this is an issue. Settings can currently not be tweaked from within Modoboa.

After creation of the file nothing has changed to the GUI, so the screenshots provided here are still as it is. So editing is not possible. I assume this is by design?

Also note (more an OfflineIMAP issue, and something not easily to be avoided): passwords will be stored unencrypted in a file on disk.

<!-- gh-comment-id:2115856478 --> @olaf7 commented on GitHub (May 16, 2024): Please note: effectively this issue should be split into two issues imho. My bad. 1. mismatch settings v1/v2 and 2. IMAP migration Also: can you comment on how I can help debug this as clearly something is wrong (as can be seen by screenshots), but you cannot reproduce. To answer your question regarding the imap_sync issue: I created a .offlineimaprc based on the template, but it fails for a couple of reasons: 1. IIRC no domain and accounts should be created in advance. There is no existing domain, so no domain admin. Therefor I need to use Modoboa Administrator. This user has no postbox, so no Dovecot login, so offlineimap fails. 2. You do not know upfront what the remote IMAP server type is and what configuration is supported / what tweaking is required. Obviously I know what the server is in my case, but in general this is an issue. Settings can currently not be tweaked from within Modoboa. After creation of the file nothing has changed to the GUI, so the screenshots provided here are still as it is. So editing is not possible. I assume this is by design? Also note (more an OfflineIMAP issue, and something not easily to be avoided): passwords will be stored unencrypted in a file on disk.
Author
Owner

@Spitfireap commented on GitHub (May 16, 2024):

Please create another issue for the sync issue and keep this one for generation.

<!-- gh-comment-id:2115978050 --> @Spitfireap commented on GitHub (May 16, 2024): Please create another issue for the sync issue and keep this one for generation.
Author
Owner

@xinomilo commented on GitHub (Oct 17, 2025):

(sorry for the noize, but maybe the issue title and OP needs to change? this issue is about offlineimap, not imapsync., completely different things)

<!-- gh-comment-id:3415376530 --> @xinomilo commented on GitHub (Oct 17, 2025): (sorry for the noize, but maybe the issue title and OP needs to change? this issue is about offlineimap, not imapsync., completely different things)
Author
Owner

@tonioo commented on GitHub (Nov 13, 2025):

@olaf7 Now that v1 is not there anymore, could you review the content of this issue and maybe create a new one?

<!-- gh-comment-id:3528614675 --> @tonioo commented on GitHub (Nov 13, 2025): @olaf7 Now that v1 is not there anymore, could you review the content of this issue and maybe create a new one?
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
starred/modoboa-modoboa#1814
No description provided.