Repository navigation
Release 0.3.2 - Devcontainer Prerequisites Validation
π― Highlights
Comprehensive prerequisites validation system to prevent "login hell" when setting up devcontainers!
β¨ Added
Devcontainer Prerequisites Validation
- β
5-step validation script (
setup-user-conf.sh) - β GHCR authentication check (Docker/Podman)
- β
SSH public key validation (
id_ed25519_github.pub) - β Allowed-signers file check
- β Git configuration validation (user.name/email)
- β GitHub CLI authentication check
- β Detailed setup instructions for missing prerequisites
- β Clear distinction between required errors and optional warnings
- β Actionable commands to fix issues
π Changed
README Documentation
- Added prominent prerequisite validation tip in Requirements section
- Created comprehensive "Host Machine Prerequisites" section
- Added GHCR authentication setup with token creation steps
- Documented Git configuration alternatives for SSH/remote scenarios
- Added SSH key setup with specific naming requirements
- Documented allowed-signers file setup
- Added GitHub CLI authentication instructions
- Created "Quick Validation - Test All Logins" section
- Updated Quick Start with "Test All Logins and Prerequisites" step
- Added note about Docker/Podman interchangeability
Setup Scripts
- Enhanced
setup-user-conf.shwith environment variable fallback - Added
GIT_USER_NAMEandGIT_USER_EMAILenvironment variable support for SSH scenarios
π Fixed
- Improved devcontainer setup UX by preventing "login hell"
- Better error messaging for missing prerequisites
- Clear guidance for SSH/remote server scenarios (#18)
π Quick Start
Before opening the devcontainer, run:
.devcontainer/setup-user-conf.shThis will validate all your logins and show you exactly what needs to be fixed!
Full Changelog: 0.3.1...0.3.2