stalwart-bootstrap 1.0.6-1
Package Information
| Description | Helps bootstraping stalwart configuration Not needed on a running stalwart instance. Intended place to install is on computer of an adminstrator, such as desktop or laptop. Use cases: - Avoiding webbrowser task upon setup - Having initial configuration in a text file See this package as "bootstrap only" version of stalwart-cli. |
|---|---|
| Maintainer | Geert Stappers <stappers@debian.org> |
| Changed By | Geert Stappers <stappers@debian.org> |
| Sponsor | stappers@debian.org |
| Distribution | unstable |
| Architecture | all |
| VCS | git: https://salsa.debian.org/debian/stalwart-bootstrap.git (browse) |
| Closes | #1153460 |
| Tracker | https://tracker.debian.org/pkg/stalwart-bootstrap |
| Uploaded | 2 hours ago |
New Package Report
.changes
| Version | 1.0.6-1 |
|---|---|
| Changed-By | Geert Stappers <stappers@debian.org> |
| Architecture | source all |
| Distribution | unstable |
| Date | Thu, 19 Nov 2026 21:22:35 +0100 |
| Source | stalwart-bootstrap |
Changelog
stalwart-bootstrap (1.0.6-1) unstable; urgency=medium . * Initial release. (Closes: #1153460)
.dsc
| Section | |
|---|---|
| Priority | optional |
| Component | main |
| Package-List | stalwart-bootstrap deb mail optional arch=all |
debian/copyright
Format: https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/ Source: https://codeberg.org/stappers/stalwart-bootstrap Upstream-Name: stalwart-bootstrap Upstream-Contact: Geert Stappers <stappers@stappers.it> Files: * Copyright: 2026 Geert Stappers <stappers@stappers.it> License: GPL-2.0+ Files: debian/* Copyright: 2026 Geert Stappers <stappers@debian.org> License: GPL-2.0+ License: GPL-2.0+ This package is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. . This package is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. . You should have received a copy of the GNU General Public License along with this package. If not, see <https://www.gnu.org/licenses/>. Comment: On Debian systems, the complete text of the GNU General Public License version 2 can be found in "/usr/share/common-licenses/GPL-2".
DFSG Assistant LLM REVIEW 0 blocker, 1 important, 1 minor
This is an LLM based review using a Debian Inference based workflow. It was not written by a member of the DFSG team and has not been checked by one. It is not a decision on the package: it may be wrong, and it may have missed things.
Reviewed 1 hour ago.
Report
DFSG NEW review for stalwart-bootstrap version 1.0.6-1
Summary
- Licensing is DFSG-compliant and
debian/copyrightis accurate: Yes - Packaging is of good quality: No
- Issues: 0 blocker, 1 important, 1 minor
- debian/watch: version 5
- debian/copyright: machine-readable
- Scan before the review: nothing found
Licensing
The whole tree (Makefile, README.md, stalwart-bootstrap, stalwart-bootstrap.1.md) is GPL-2, held by Geert Stappers, and debian/copyright is DEP-5 with a catch-all Files: * stanza, a debian/* override, and a standalone GPL-2+ paragraph pointing at /usr/share/common-licenses/GPL-2. Nothing non-free or unlicensed is present, no third-party or vendored code, and no built artefacts are shipped. Two small gaps: the script's only licence comment says "GPL v2" without "or later" while the copyright file grants GPL-2+, and upstream ships no COPYING file; neither makes the package non-free, since the sole copyright holder makes the GPL-2+ grant himself, but they should be aligned.
Packaging
The packaging is small and mostly works: compat 13, dh $@, correct pandoc build dependency, correct curl/jq runtime dependencies, one binary package, a proper man page built from the markdown source, and a well-formed first changelog entry. The blocker for a clean upload is documentation accuracy: the installed man page documents STALWART-BOOTSTRAP_ADMIN and STALWART-BOOTSTRAP_PORT, but the script reads STABOB_ADMIN and STABOB_PORT, and the documented names are not even valid shell identifiers, so the documented way to point the tool at a server does nothing.
Issues
important packaging 1. Man page documents STALWART-BOOTSTRAP_ADMIN/_PORT, but the script reads STABOB_ADMIN/STABOB_PORT ◂
- Files:
stalwart-bootstrap.1.md:40,stalwart-bootstrap.1.md:44,stalwart-bootstrap.1.md:92,stalwart-bootstrap:78,stalwart-bootstrap:83 - Basis: checked, in the package or with a reference tool
- Evidence: man source:
**STALWART-BOOTSTRAP_ADMIN**(line 40),**STALWART-BOOTSTRAP_PORT**(line 44), andNow is the time to set, to \export`, STALWART-BOOTSTRAP_ADMIN(line 92); script:if [ -z "$STABOB_ADMIN" ] ; then(line 78) andif [ -z "$STABOB_PORT" ] ; then` (line 83). - Problem: The man page is the package's only end-user documentation and it names two environment variables the script never reads. Worse, the documented names contain hyphens, so
export STALWART-BOOTSTRAP_ADMIN=user:passfails in bash with "not a valid identifier": the documented configuration path cannot be made to work at all, and a user who needs a non-default server port or credentials has no working instruction. The README.md uses yet a third spelling (STABOB_ADMIN,STABOB_PORT), confirming the man page was not updated. - Fix: Document the variables the script actually reads (
STABOB_ADMIN,STABOB_PORT) in stalwart-bootstrap.1.md lines 40-46 and 92-93, or rename the variables in the script to match the documentation (using a shell-safe name such asSTALWART_BOOTSTRAP_ADMIN), and fix README.md the same way.
minor licensing 2. Script's licence comment says "GPL v2" (no "or later") while debian/copyright grants GPL-2+, and no COPYING file is shipped ◂
- Files:
stalwart-bootstrap:100,debian/copyright:10 - Basis: checked, in the package or with a reference tool
- Evidence:
# License is GPL v2(stalwart-bootstrap:100);License: GPL-2+(debian/copyright:10 and :16); the source package contains no COPYING/LICENSE/NOTICE file. - Problem: The installed script states GPL version 2, while debian/copyright grants "either version 2 of the License, or (at your option) any later version" for the same file. The terms are free either way and the grant is valid because the sole copyright holder (Geert Stappers) writes both, so this is not a DFSG problem; it is an inconsistency a downstream user will hit when reading /usr/bin/stalwart-bootstrap, and the absence of any upstream licence file leaves the copyright file as the only record. Aligning them now avoids a later dispute about whether the "+" was ever granted.
- Fix: Either change
Files: *toGPL-2(with a standaloneLicense: GPL-2paragraph pointing at /usr/share/common-licenses/GPL-2), or add an explicit "version 2, or (at your option) any later version" statement to the script and README and have upstream ship a COPYING file.
Verified ◂
- The pre-scan reported no unmatched copyright holders and no files needing explanation; its "4 files scanned" are exactly the four upstream files (Makefile, README.md, stalwart-bootstrap, stalwart-bootstrap.1.md), and I read all four in full.
- Read every file under debian/ (control, changelog, copyright, rules, README.source, gbp.conf, watch, source/format, upstream/metadata, patches/series, patches/format-manual-page.patch).
- debian/copyright is DEP-5 with a Format header;
Files: *(line 6) covers all upstream files anddebian/*(line 13) covers the packaging including debian/patches/format-manual-page.patch, since*matches/; the later stanza correctly overrides for debian/. The GPL-2 text requirement is met by the pointer to /usr/share/common-licenses/GPL-2 in the standalone License paragraph. - No generated or binary files are shipped: the only build product, stalwart-bootstrap.1, is produced at build time by the Makefile's
manualtarget from stalwart-bootstrap.1.md with pandoc (a declared Build-Depends) and is not in the tarball. - No third-party, vendored or embedded code, no fonts/images/data files, and no non-free terms anywhere in the tree; the only licence wording found by grep is
# License is GPL v2in the script. - Patch reviewed: debian/patches/format-manual-page.patch only adds
manualto thealltarget; since the upstreaminstall: stalwart-bootstrap.1target already builds the man page,dh_auto_installwould produce it anyway, so the patch is redundant but harmless, and it carries From/Date/Subject/Forwarded headers. - Standards-Version 4.7.4 matches the reviewing system's Policy 4.7.4.1 (first two components), so it is current.
- Compat level 13 via
debhelper-compat (= 13)and%: dh $@; at compat 13 dh_auto_install uses debian/stalwart-bootstrap as the destdir for a single binary package and dh_missing defaults to --fail-missing —make installinstalls only the script and the man page, so nothing is left over and no override is needed. - Build-Depends is complete for the build: debhelper-compat, and pandoc for the Makefile's manual target; the runtime Depends (curl, jq) match the two external commands the script runs, and bash used by the shebang is essential.
- changelog: correct package/version
stalwart-bootstrap (1.0.6-1), distribution unstable, an ITP closure, and a valid signature date (2026-11-19 is a Thursday); Homepage and Vcs-* point at the same upstream and Debian repositories named in debian/copyright's Source field. - uscan found the packaged version as the newest upstream release (upstream
1.0.6, packaged1.0.6). - Every pointer of
debian/copyrightto /usr/share/common-licenses names a file that is there (GPL-2).
Not confirmed ◂
- No network access, so I could not confirm that the Salsa repo or bug #1153460 exist.
- The man page footer still says
stalwart-bootstrap 1.0.3while the package is 1.0.6; cosmetic, not counted as an issue.
Proposed changes ◂
None.
Uploader's response to the LLM review
The uploader was emailed about the review 1 hour ago.