---
name: "mailman2lurker"
section: "8"
platform: "linux"
package: "lurker"
version: "2.3-6+b1"
release: "Debian 11 (Bullseye)"
platforms: ["linux"]
url: "https://new.carta.tech/mailman2lurker"
---

# mailman2lurker(8)

Import mailman lists and their archives into a lurker database.

## NAME

mailman2lurker - Import mailman lists and their archives into a lurker database.

## SYNOPSIS

 **mailman2lurker** **-i**\|**-p** \[*options*\]

## DESCRIPTION

**mailman2lurker** has mainly two functions. First, it parses mailman's lists and creates a lurker configuration include out of them. Second, it imports archives from mailman lists into a lurker database.

To build a new lurker database from mailmans archives, first run '**mailman2lurker -p**'. Next you need to add '**include =** **/etc/lurker/lurker.conf.mailman**' into /etc/lurker/lurker.conf.local. Finally import mailmans mboxes by running '**mailman2lurker -i**'.

If you want to add new lists to an already existing lurker configuration, run '**mailman2lurker -p -w newlists**' and afterwards '**mailman2lurker -i -f** **newlists**'. This will import only the mbox files of mailman lists that have been added to the lurker configuration because they were new to lurker.

## COMMANDS

- **-p**, **--parse**

  Parse mailman lists, and create a lurker configuration include file containing all parsed lists. Lists that are already configured in lurker are ignored.

- **-i**, **--import**

  Import archives of all lists. This parses the lurker configuration and imports the mailman mbox at /var/lib/mailman/archives/private/\<list\>.mbox/\<list\>.mbox for every list.

## OPTIONS

- **-c**, **--config** \<*config*\>

  Use \<*config*\> as lurker configuration file. Default: /etc/lurker/lurker.conf

- **-o**, **--outfile** \<*outfile*\>

  Write list configuration to \<*outfile*\>. If this is not specified, \<lurker.conf\>.mailman will be used. This option is only useful in conjunction with **-p**.

- **-g**, **--group** \<*group*\>

  Use \<*group*\> for new lists. Default is 'undef'. This option is only useful in conjunction with **-p**.

- **-a**, **--listhost** \<*listhost*\>

  Use \<*listhost*\> as host for new list addresses. If a new list is called 'mylist' and \<*listhost*\> is lists.org, then the list address will be mylist@lists.org. Default is 'example.org'. This option is only useful in conjunction with **-p**.

- **-l**, **--link** \<*url link*\>

  Use \<*url link*\> as base for links of new lists. If a list is called 'mylist', and \<*url link*\> is 'http://lists.org', then the link address will be http://lists.org/mylist. Default is 'http://example.org'. This option is only useful in conjunction with **-p**.

- **-s**, **--lang** \<*language*\>

  Use \<*language*\> as language for new lists. Needs to be a language token. Default is 'en'. This option is only useful in conjunction with **-p**.

- **-w**, **--write-lists** \<*file*\>

  Write a list of all lists that have been added to the lurker configuration. Safe that list in \<*file*\>. Default is off. This option is only useful in conjunction with **-p**.

- **-x**, **--list-cmd** \<*file*\>

  Use \<*command\|file*\> to get the list of mailman lists that should be parsed. When \<*command\|file*\> is a command, it needs to end with ' \|'. Default is '/var/lib/mailman/bin/list\_lists \|'. This option is only useful in conjunction with **-p**.

- **-f**, **--listfile** \<*file*\>

  Import only lists that are listed in \<*file*\>. This option is only useful in conjunction with **-i**.

- **-d**, **--lists** \<*one*\[,*two*,*...*\]\>

  Import only lists that are given as argument. This option is only useful in conjunction with **-i**.

- **-h**, **--help**

  Display a help message.

- **-v**, **--version**

  Display mailman2lurker's version number.

## SEE ALSO

[**list\_lists**(8)](/list_lists/8.md), **lurker-index**(8)

## AUTHOR

This program was written by Jonas Meurer \<jonas@freesources.org\>.

## COPYRIGHT

mailman2lurker may be copied and modified under the terms of the GNU General Public License.