Skip to content

fix: pullgate-listen.service has no [Install] section, so enable fails and the listener does not start after a reboot #20

Closed

Description

@groupsky

Problem

contrib/systemd/pullgate-listen.service in v0.1.0 has no [Install] section. The README says to run systemctl enable --now pullgate-listen.service, but systemd answers:

The unit files have no installation config (WantedBy=, RequiredBy=, UpheldBy=,
Also=, or Alias= settings in the [Install] section ...

It starts the listener now, but the listener does not start after a reboot. Then no question gets an answer until someone starts it by hand.

Found on 2026-11-16, in the first real install of v0.1.0. Workaround: systemctl add-wants multi-user.target pullgate-listen.service.

Proposal

Add to pullgate-listen.service:

[Install]
WantedBy=multi-user.target

Done when

  • pullgate-listen.service has [Install] with WantedBy=multi-user.target.
  • A CI check runs systemd-analyze verify on every unit in contrib/systemd/, and checks that each unit the README tells you to enable has an [Install] section.
  • The README says what to do on a host that has the workaround (systemctl remove-wants multi-user.target pullgate-listen.service, then systemctl enable pullgate-listen.service).
  • The fix is in a released version.

Activity

  1. groupsky commented on Nov 16, 2026

    @groupsky
    ContributorAuthor

    Fixed in #24 (squash commit 053d0aa). Evidence for each box:

    • pullgate-listen.service has [Install] with WantedBy=multi-user.target. See contrib/systemd/pullgate-listen.service at the end.
    • A CI check runs systemd-analyze verify on every unit in contrib/systemd/, and checks that each unit the README tells you to enable has an [Install] section. CI job "example units": systemd-analyze verify on every unit (this was there before), and the new test/units/install-sections.sh, which reads the systemctl enable lines of the README. The CI job "first run under the units" also runs systemctl enable on the four units as root, and each must then be enabled. On the old unit both failed: FAIL: contrib/systemd/pullgate-listen.service has no [Install] section with WantedBy= and FAIL: pullgate-listen.service: systemctl is-enabled says 'static' after enable, want 'enabled'.
    • The README says what to do on a host that has the workaround. README, "Update from 0.1.0" → "The listener at boot": systemctl daemon-reload, then systemctl reenable pullgate-listen.service. Note: systemctl remove-wants does not exist (systemd 255 has only add-wants), so the README does not use it. The add-wants workaround made the same link that enable makes now, and reenable removes it and makes it again. Every host updated from 0.1.0 needs this step, with or without the workaround. CI tests these exact steps: the old unit with add-wants, then the new unit, daemon-reload and reenable; the link must exist and is-enabled must say enabled.
    • The fix is in a released version. Waits for the next release, which also holds fix: pullgate --version fails with "flag provided but not defined" #14 and fix: the first run fails: RestrictSUIDSGID=yes in pullgate-run@.service blocks the setgid outbox #19.

    Both reviews ran (the security reviewer and a correctness review). What they found and what was fixed is in the description of #24.

  2. groupsky commented on Nov 16, 2026

    @groupsky
    ContributorAuthor

    Reopened: GitHub closed this on the merge, but the last "Done when" box (the fix is in a released version) is still open. The release PR #18 waits for the owner's OK. Close this after the release.

  3. groupsky commented on Nov 16, 2026

    @groupsky
    ContributorAuthor

    All boxes are met, so I close this issue.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    bugSomething isn't workingpriority: highDo this first

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions