Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[Feature] Document the use of keys.txt in the readme, provide dummy keys.txt file with dummy data #508

Open
observeroftime02 opened this issue Dec 29, 2024 · 2 comments
Labels
enhancement New feature or request

Comments

@observeroftime02
Copy link

observeroftime02 commented Dec 29, 2024

Is your feature request related to a problem? Please describe.
When launching NUT without a keys.txt file, the application complains on the command line that "could not load keys.txt, all crypto operations will fail". Trying to find out what sort of format the application expects is challenging, because it is not documented in the readme. Not everyone can read and understand the source to figure out the proper layout of the file.

Describe the solution you'd like
Provide an example in the readme, such as "place a file called keys.txt in X directory, the entries should look like Y". I can guess it wants my prod.keys file, however that file is a binary, not a text file. Having an example entry with dummy data would help me format the text file correctly.

It would also help if I could find out what operations keys are required for, to determine if I should bother creating such a file in the first place. The current description of "crypto operations" is pretty vague for the average user. I'm assuming it is related to the compress / decompress options?

Describe alternatives you've considered
Searched the issue tracker for a solution or answer, found none.

@observeroftime02 observeroftime02 added the enhancement New feature or request label Dec 29, 2024
@Fronti
Copy link

Fronti commented Dec 30, 2024

You mean like keys_template.txt?

Btw, prod.keys is a text file. Just rename it to keys.txt and it'll be happy.

@observeroftime02
Copy link
Author

🤦‍♂️I swear I have a special kind of pigeon brain sometimes. Thank you! In my defense, the file did not exist as part of the download.

It might be worthwhile pointing the existence of this file out in the readme (for people such as myself), other than that, suggestion can be closed. Everything is working.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
enhancement New feature or request
Projects
None yet
Development

No branches or pull requests

2 participants