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

Improve Installation Process and Documentation for New Users #632

Open
nickt28 opened this issue Jul 7, 2024 · 0 comments
Open

Improve Installation Process and Documentation for New Users #632

nickt28 opened this issue Jul 7, 2024 · 0 comments

Comments

@nickt28
Copy link

nickt28 commented Jul 7, 2024

As a web developer new to Linux systems and console usage, I encountered significant difficulties installing USBGuard on the latest version of Ubuntu 24.04 from scratch. These challenges are likely to deter many potential users from this tool. I'd like to share my experience and suggest improvements to make USBGuard more accessible to newcomers.

Issues encountered:

  1. Incomplete or implied instructions in the installation guide
  2. Incorrect directory paths in some commands (e.g., "/etc/usbguard/rules.conf" instead of "/usr/local/etc/usbguard/rules.conf")
  3. Missing steps to create necessary directories (e.g., "sudo mkdir -p /usr/local/etc/usbguard/rules.d")
  4. Daemon start errors
  5. Linking errors requiring additional steps (e.g., "sudo ldconfig /usr/local/lib")
  6. Build errors
  7. Permission errors

The process took around 3 hours and was spent resolving consecutive errors, which was frustrating. Without the help of Claude Sonnet AI, I would have been completely lost.

Suggestions for improvement:

  1. Create an automated installation script for just 1 or 2 popular distributions (e.g., Ubuntu 24.04)
  2. Provide a more detailed, step-by-step installation guide that includes all necessary commands and potential troubleshooting steps
  3. Include a "common issues" section in the documentation
  4. Implement more user-friendly error messages in the installation process
  5. Add a "quick start" guide for beginners
  6. Regularly test the installation process on fresh machines to catch potential issues

I appreciate the effort put into developing this tool and hope this feedback helps improve its accessibility. Thank you for considering these suggestions.

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

No branches or pull requests

1 participant