[account]
    account_unsetmultipleprimaryemails

[auth]
    changepassword
    createsuperuser          ✓

[compressor]
    compress                 ✓
    mtime_cache

[contenttypes]
    remove_stale_contenttypes

[django]
    check
    compilemessages
    createcachetable
    dbshell
    diffsettings
    dumpdata
    flush
    inspectdb
    loaddata
    makemessages
    makemigrations
    migrate                  ✓
    optimizemigration
    sendtestemail
    shell                    ✓

[django_q]
    qcluster                 ✓（服务形态运行）
    qinfo                    ✓
    qmemory
    qmonitor

[haystack]
    build_solr_schema
    clear_index
    haystack_info            ✓
    rebuild_index
    update_index             ✓

[hyperkitty]
    attachments_to_file
    hyperkitty_import        ✓
    hyperkitty_warm_up_cache
    mailman_sync
    update_index_one_list    ✓

[postorius]
    mmclient
    reset_passwords

[rest_framework]
    generateschema

[sessions]
    clearsessions

[staticfiles]
    collectstatic            ✓
    findstatic
    runserver

mailman-web hyperkitty_import --help

usage: mailman-web hyperkitty_import [-h] [--delete] [-l LIST_ADDRESS]
                                     [--no-sync-mailman] [--since SINCE]
                                     [--ignore-mtime] [--version]
                                     [-v {0,1,2,3}] [--settings SETTINGS]
                                     [--pythonpath PYTHONPATH] [--traceback]
                                     [--no-color] [--force-color]
                                     [--skip-checks]
                                     mbox [mbox ...]

Imports the specified archive mbox(es). Before running this, the mbox(es)
should be checked for messages that could throw uncaught exceptions with the
contrib/check_hk_archive script and for unescaped 'From ' lines with Mailman
2.1's cleanarch script.

positional arguments:
  mbox

options:
  -h, --help            show this help message and exit
  --delete              Delete poll instead of closing it
  -l LIST_ADDRESS, --list-address LIST_ADDRESS
                        the full list address the mailbox will be imported to
  --no-sync-mailman     do not sync properties with Mailman (faster, useful
                        for batch imports)
  --since SINCE         only import emails later than this date. Defaults to

cat > /tmp/hk-import.mbox <<'EOF'
From tester@example.com  Mon Oct 26 05:10:00 2026
From: Tester <tester@example.com>
To: testlist@example.com
Subject: [Testlist] imported from mbox demo 1
Message-ID: <hk-import-0001@example.com>
Date: Mon, 26 Oct 2026 05:10:00 +0000

First imported message body.

From tester@example.com  Mon Oct 26 05:11:00 2026
From: Tester <tester@example.com>
To: testlist@example.com
Subject: [Testlist] imported from mbox demo 2
Message-ID: <hk-import-0002@example.com>
Date: Mon, 26 Oct 2026 05:11:00 +0000

Second imported message body.
EOF

mailman-web hyperkitty_import -l testlist@example.com /tmp/hk-import.mbox

?: settings.ACCOUNT_AUTHENTICATION_METHOD is deprecated, use: settings.ACCOUNT_LOGIN_METHODS = {'email', 'username'}
?: settings.ACCOUNT_EMAIL_REQUIRED is deprecated, use: settings.ACCOUNT_SIGNUP_FIELDS = ['email*', 'username*', 'password1*', 'password2*']
Warning: not importing messages older than Oct. 26, 2026. Use "--since=<date>" to import older messages.
Importing from mbox file /tmp/hk-import.mbox to testlist@example.com
|/Computing thread structure
Synchronizing properties with Mailman
Warming up cache
The full-text search index is not updated for this list. It will not be updated by the 'minutely' incremental update job. To update the index for this list, run the Django admin command with arguments 'update_index_one_list testlist@example.com'.

mailman-web hyperkitty_import -l testlist@example.com --since=2026-10-01 /tmp/hk-import.mbox

?: settings.ACCOUNT_EMAIL_REQUIRED is deprecated, use: settings.ACCOUNT_SIGNUP_FIELDS = ['email*', 'username*', 'password1*', 'password2*']
Importing from mbox file /tmp/hk-import.mbox to testlist@example.com
|/Computing thread structure
Synchronizing properties with Mailman
Warming up cache
The full-text search index is not updated for this list. It will not be updated by the 'minutely' incremental update job. To update the index for this list, run the Django admin command with arguments 'update_index_one_list testlist@example.com'.

mailman-web update_index_one_list testlist@example.com

?: settings.ACCOUNT_AUTHENTICATION_METHOD is deprecated, use: settings.ACCOUNT_LOGIN_METHODS = {'email', 'username'}
?: settings.ACCOUNT_EMAIL_REQUIRED is deprecated, use: settings.ACCOUNT_SIGNUP_FIELDS = ['email*', 'username*', 'password1*', 'password2*']
Indexing 4 emails

mailman-web update_index

?: settings.ACCOUNT_AUTHENTICATION_METHOD is deprecated, use: settings.ACCOUNT_LOGIN_METHODS = {'email', 'username'}
?: settings.ACCOUNT_EMAIL_REQUIRED is deprecated, use: settings.ACCOUNT_SIGNUP_FIELDS = ['email*', 'username*', 'password1*', 'password2*']
Indexing 4 emails

mailman-web haystack_info

?: settings.ACCOUNT_AUTHENTICATION_METHOD is deprecated, use: settings.ACCOUNT_LOGIN_METHODS = {'username', 'email'}
?: settings.ACCOUNT_EMAIL_REQUIRED is deprecated, use: settings.ACCOUNT_SIGNUP_FIELDS = ['email*', 'username*', 'password1*', 'password2*']
Number of handled 1 index(es).
  - Model: Email by Index: <hyperkitty.search_indexes.EmailIndex object at 0x793e8de1e990>

curl -s -o /dev/null -w 'list archive page: %{http_code}\n' \
  http://127.0.0.1/hyperkitty/list/testlist@example.com/

list archive page: 200

mailman-web migrate                 # 建表/增量迁移（升级版本后必跑）

Apply all migrations: account, admin, auth, contenttypes, django_mailman3, django_q, hyperkitty, postorius, sessions, sites, socialaccount
Running migrations:
  No migrations to apply.

mailman-web collectstatic --noinput

0 static files copied to '/opt/mailman/mm/static', 387 unmodified.

mailman-web compress --force

Compressing... done
Compressed 2 block(s) from 80 template(s) for 1 context(s).

mailman-web createsuperuser --noinput --username admin --email admin@example.com

echo "from django.contrib.auth.models import User; u=User.objects.get(username=\"admin\"); u.set_password(\"q1w2e3r4\"); u.save(); print(\"password set for\", u.username, \"is_superuser=\", u.is_superuser)" \
  | mailman-web shell

password set for admin is_superuser= True

mailman-web qinfo

System check identified some issues:

WARNINGS:
?: settings.ACCOUNT_AUTHENTICATION_METHOD is deprecated, use: settings.ACCOUNT_LOGIN_METHODS = {'username', 'email'}
?: settings.ACCOUNT_EMAIL_REQUIRED is deprecated, use: settings.ACCOUNT_SIGNUP_FIELDS = ['email*', 'username*', 'password1*', 'password2*']
Blessed is not installed. Please install blessed to use this: https://pypi.org/project/blessed/

curl -s -o /dev/null -w '%{http_code}\n' \
  'http://127.0.0.1:8000/hyperkitty/api/mailman/urls?mlist=testlist@example.com' \
  -H 'Authorization: Token SecretArchiverAPIKey'

200

ls -A /opt/mailman/mm/var/archives/hyperkitty/spool/ | wc -l

0

grep 'HyperKitty archived message' /opt/mailman/mm/var/log/mailman.log | tail -2

Oct 26 00:40:21 2026 (9930) HyperKitty archived message <hk-test-0004@example.com> to https://example.com/archives/list/testlist@example.com/message/LSYJ6VGPXOBKXXQFHCHC3ED5JGJE7ZMP/
Oct 26 00:40:22 2026 (9930) HyperKitty archived message <hk-test-0005@example.com> to https://example.com/archives/list/testlist@example.com/message/5UM26TOV44FCHPDMDPARZJSZHKNUKRKS/

systemctl is-active mailman3 mailman-web nginx
curl -s -o /dev/null -w '%{http_code}\n' http://127.0.0.1/hyperkitty/

active
active
active

200