docs: clarified systemd installation instructions in init.md for Ubuntu users. #12452

pull DaveFromBinary wants to merge 1 commits into bitcoin:master from DaveFromBinary:doc-init-updates changing 1 files +4 −0
  1. DaveFromBinary commented at 6:50 PM on February 16, 2018: contributor

    Added a note to init.md to clarify the .service copy path for Ubuntu because it differs from the described copy path.

    Also noted which version of Ubuntu switched to systemd for the default system init to clarify when the systemd installation steps should be used instead of the upstart installation steps for Ubuntu users.

  2. DaveFromBinary renamed this:
    [Docs] Clarified systemd installation instructions in init.md for Ubuntu users.
    docs: clarified systemd installation instructions in init.md for Ubuntu users.
    on Feb 16, 2018
  3. randolf approved
  4. fanquake added the label Docs on Feb 16, 2018
  5. laanwj commented at 9:27 AM on February 17, 2018: member

    utACK; though a possible suggestion would be to start out with the assumption that someone is using Ubuntu > 15.04, and add a note for older versions. Or is the /usr/lib/systemd/system path still the default in other Linux distributions, and Ubuntu is the exception here?

  6. DaveFromBinary commented at 2:26 PM on February 17, 2018: contributor

    Thanks for the feedback! It looks like Ubuntu is the exception to me.

    I'm not a Linux expert, but based on the research I just did it looks like /usr/lib/systemd/system is still the default path for most other distributions (making Debian/Ubuntu the exception).

    I was trying to keep my change as minimal as possible but I agree that assuming latest and adding notes to the more outdated or non-default options would be clearer. Would it be preferred to change the first comment to this:

    NOTE: When installing for systemd in Debian/Ubuntu the .service file needs to be copied to the /lib/systemd/system directory instead.

    And to add a second comment in the Upstart section mentioning that it is no longer the default? Like this:

    Upstart was the default init system for Debian/Ubuntu versions older than 15.04. If you are using version 15.04 or newer and haven't manually configured upstart you should follow the systemd instructions instead.

    When I saw Debian/Ubuntu mentioned in the header for Upstart, I tried those steps first myself before getting stuck.

  7. randolf commented at 5:12 PM on February 17, 2018: contributor

    @DaveFromBinary The updated text seems more user-friendly as well as being completely neutral with regard to a Ubuntu-specific change. So, I think the newer text is better.

  8. docs: clarified systemd installation instructions in init.md for Ubuntu users.
    Added a note to init.md to clarify the .service copy path for newer versions of Ubuntu because it differs from the described copy path.
    
    Also noted what version of Ubuntu switched to systemd for the default system init.
    4d14d06fcb
  9. DaveFromBinary force-pushed on Feb 18, 2018
  10. randolf approved
  11. jonasschnelli approved
  12. jonasschnelli commented at 1:03 AM on February 25, 2018: contributor

    ACK 4d14d06fcbd63c64257c09ef0a09ad84efdb6d2e

  13. fanquake commented at 4:39 PM on March 5, 2018: member

    utACK 4d14d06

  14. laanwj merged this on Mar 5, 2018
  15. laanwj closed this on Mar 5, 2018

  16. laanwj referenced this in commit 71f56da384 on Mar 5, 2018
  17. Janaka-Steph commented at 5:47 PM on July 27, 2018: none

    @DaveFromBinary

    Not an expert but from my research, on Debian/Ubuntu the package provided unit files go in /lib/systemd/system/ directory, whereas the user provided or any modification to the package provided unit files go in /etc/systemd/system/ directory.

    So, on Debian/Ubuntu, I would rather put bitcoind.service in /etc/systemd/system/ directory.

    See: https://unix.stackexchange.com/questions/368100/where-to-place-user-created-systemd-unit-files#answer-368124

  18. DaveFromBinary commented at 6:12 PM on July 27, 2018: contributor

    @Janaka-Steph

    I'm not an expert on Dedian/Ubuntu either but my understanding (and reading of the stackexchange link you provided) is that the package provided files should go in /lib/systemd/system/ which would include bitcoind.service. Whereas configuration files should go in /etc/systemd/system/ like bitcoin.conf.

  19. Janaka-Steph commented at 11:19 PM on July 27, 2018: none

    @DaveFromBinary

    From what I understand /etc/systemd/system is used to override /(usr)/lib/systemd/system/ The system should not write anything in /etc (in theory), it's our space. I would put the service file to /etc/systemd/system and reserve /lib/systemd/system/ for the system, it has a lot of pre-installed service files (or units to employ the systemd term).

    Also, systemd has multiple instances, one for the system, and one instance by user connected. So I am wondering if we can use the user's service manager for managing and configuring the bitcoin service, which will operate on our user's service manager, not the one of the system. But it can cause other headaches. See this link: https://wiki.archlinux.org/index.php/Systemd/User#How_it_works

  20. PastaPastaPasta referenced this in commit 2b42195f3a on Jul 17, 2020
  21. PastaPastaPasta referenced this in commit 36e90869b5 on Jul 17, 2020
  22. jasonbcox referenced this in commit e041c1c86b on Oct 31, 2020
  23. MarcoFalke locked this on Sep 8, 2021

github-metadata-mirror

This is a metadata mirror of the GitHub repository bitcoin/bitcoin. This site is not affiliated with GitHub. Content is generated from a GitHub metadata backup.
generated: 2026-04-22 18:15 UTC

This site is hosted by @0xB10C
More mirrored repositories can be found on mirror.b10c.me