DFSG NEW Queue

DFSG, Licensing & New Packages Team

stalwart-bootstrap 1.0.6-1

Package Information

DescriptionHelps 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.

MaintainerGeert Stappers <stappers@debian.org>
Changed ByGeert Stappers <stappers@debian.org>
Sponsorstappers@debian.org
Distributionunstable
Architectureall
VCSgit: https://salsa.debian.org/debian/stalwart-bootstrap.git (browse)
Closes#1153460
Trackerhttps://tracker.debian.org/pkg/stalwart-bootstrap
Uploaded2 hours ago

New Package Report

.changes◂
Version1.0.6-1
Changed-ByGeert Stappers <stappers@debian.org>
Architecturesource all
Distributionunstable
DateThu, 19 Nov 2026 21:22:35 +0100
Sourcestalwart-bootstrap
Changelog◂
stalwart-bootstrap (1.0.6-1) unstable; urgency=medium
 .
   * Initial release. (Closes: #1153460)
.dsc◂
Sectionmail
Priorityoptional
Componentmain
Package-Liststalwart-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/copyright is 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), and Now 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:pass fails 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 as STALWART_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: * to GPL-2 (with a standalone License: GPL-2 paragraph 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 and debian/* (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 manual target 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 v2 in the script.
  • Patch reviewed: debian/patches/format-manual-page.patch only adds manual to the all target; since the upstream install: stalwart-bootstrap.1 target already builds the man page, dh_auto_install would 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 install installs 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, packaged 1.0.6).
  • Every pointer of debian/copyright to /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.3 while 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.

Back to Dashboard | View all reviews for this package