starred/acme-dns-client
1
0
Fork 0
mirror of https://github.com/acme-dns/acme-dns-client.git synced 2026-04-25 21:35:57 +03:00
Code Issues 20 Projects Releases 3 Packages Wiki Activity

[GH-ISSUE #17] Docs for first time #10

New issue
Open
opened 2026-03-13 16:26:15 +03:00 by kerem · 0 comments
kerem commented 2026-03-13 16:26:15 +03:00
Owner
Copy link

Originally created by @mslinn on GitHub (Aug 18, 2022).
Original GitHub issue: https://github.com/acme-dns/acme-dns-client/issues/17

  1. The first time acme-dns-client is run, it must be run as root, or the following error will appear unless the user knew to create /etc/acmedns:

    $ acme-dns-client --help
Error while starting up: mkdir /etc/acmedns: permission denied

    It would be good to generate the help message before the program attempts to access /etc/acmedns. Even better, tell the user that the directory does not exist, which means that acme-dns needs to be configured before using acme-dns-client.

  2. Here is a possible addition to the docs: If acme-dns-client is run under sudo, another issue presents. Because sudo filters out environment variables such as GOPATH by default, and changes the default GOPATH to /root/go/bin/, the first time acme-dns-client is run, it must be invoked via its fully qualified path, like this:

    $ sudo /home/user_name/go/bin/acme-dns-client --help
Originally created by @mslinn on GitHub (Aug 18, 2022). Original GitHub issue: https://github.com/acme-dns/acme-dns-client/issues/17 1) The first time `acme-dns-client` is run, it must be run as root, or the following error will appear unless the user knew to create `/etc/acmedns`: ``` $ acme-dns-client --help Error while starting up: mkdir /etc/acmedns: permission denied ``` It would be good to generate the help message before the program attempts to access `/etc/acmedns`. Even better, tell the user that the directory does not exist, which means that `acme-dns` needs to be configured before using `acme-dns-client`. 2) Here is a possible addition to the docs: If `acme-dns-client` is run under `sudo`, another issue presents. Because [`sudo` filters out environment variables](https://www.sudo.ws/docs/man/sudoers.man/#Command_environment) such as `GOPATH` by default, and changes the default `GOPATH` to `/root/go/bin/`, the first time `acme-dns-client` is run, it must be invoked via its fully qualified path, like this: ```shell $ sudo /home/user_name/go/bin/acme-dns-client --help ```
Sign in to join this conversation.
No Branch/Tag specified
Branches Tags
master
release03
fix_wildcard
fix_goreleaser
prepare_v0.2
v0.3
v0.2
v0.1
Labels
Clear labels   
pull-request

Mirrored from GitHub Pull Request

  
question

   
question
No labels
pull-request
question
question
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
starred/acme-dns-client#10
No description provided.