### Major macOS Compatibility Improvements
- Enhanced Docker Desktop installation and startup process for macOS
- Fixed Docker authentication with macOS keychain integration
- Resolved user directory issues - all directories now use actual user home instead of root
- Fixed password generation issues with missing shuf command and encoding errors
- Improved container creation with proper working directory context
- Enhanced healthcheck monitoring, particularly for Jellyseerr service
### Bug Fixes
- Fixed Docker Compose version warnings by removing obsolete version attribute
- Resolved container startup issues with proper directory navigation
- Fixed file permission issues for config and media directories
- Enhanced cross-platform path handling functions
- Improved error handling and user feedback throughout installation process
### Code Quality Improvements
- Updated all version references to v3.2.0
- Enhanced documentation with macOS-specific improvements
- Improved cross-platform compatibility across all components
- Better error messages and troubleshooting guidance
This release significantly improves the macOS user experience and resolves
numerous compatibility issues that were preventing successful installation
and operation on macOS systems.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
Changes all version references from 3.1.0 to 3.1.0-beta across:
- Main scripts (hops, install, uninstall, setup, etc.)
- Library modules (lib/*.sh)
- Documentation (README.md)
This reflects the pre-release status of the project before public release.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Expanded support section with clear guidance on when to contact HOPS vs service developers
- Added direct GitHub repository links for all 25+ supported services organized by category:
• Media Management (*arr stack): Sonarr, Radarr, Lidarr, Readarr, Bazarr, Prowlarr, Tdarr, Huntarr
• Download Clients: qBittorrent, Transmission, NZBGet, SABnzbd
• Media Servers: Jellyfin, Plex, Emby
• Request Management: Overseerr, Jellyseerr, Ombi, Jellystat
• Network & Security: Traefik, Nginx Proxy Manager, Authelia
• Monitoring & Management: Portainer, Watchtower, Uptime Kuma
- Added clear distinction between HOPS deployment issues vs service-specific issues
- Included notes about retired projects (Readarr) and project status
- Provided proper attribution to help users get support from the right teams
This helps users understand that HOPS handles deployment automation while individual
services are maintained by their respective development teams.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Updated platform badge to include Windows support
- Added Windows system requirements (WSL2, Docker Desktop)
- Created detailed Windows installation section with:
• Step-by-step WSL2 setup instructions
• Docker Desktop installation and configuration
• WSL2-specific HOPS installation commands
• Important performance and file location notes
- Added Windows support to CLAUDE.md development docs
- Documented WSL2 compatibility analysis findings:
• 95% native Linux performance when using WSL2 filesystem
• Full bash script compatibility via Linux kernel
• Seamless Docker Desktop integration
• Cross-filesystem access for Windows media folders
- Updated "What's New" to highlight tri-platform support
- Verified current path functions work optimally in WSL2
HOPS now officially supports Linux, macOS, and Windows\!
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Updated platform badge to show Linux | macOS support
- Added macOS system requirements (Big Sur+, Intel/Apple Silicon)
- Updated prerequisites with platform-specific details:
• Linux: Root access, x86_64 architecture
• macOS: Admin access, automatic Homebrew/Docker installation
- Fixed installation commands for renamed scripts (no .sh extensions)
- Added cross-platform support to "What's New" features
- Clarified that HOPS works natively on both platforms
Now GitHub users will know macOS is fully supported\!
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Changed macOS deployment directory from ~/homelab/ to ~/hops/
- Updated all core scripts to use new path structure:
• Main working directory: ~/hops/
• Config directory: ~/hops/config/
• Media directory: ~/hops/media/
• Environment file: ~/hops/.env
- Updated documentation in CLAUDE.md and README.md
- Changed log file naming from homelab-* to hops-*
- Linux paths remain unchanged (/opt/appdata, /mnt/media)
Benefits:
- Better brand consistency with project name
- Cleaner, more professional directory structure
- Shorter, easier to remember paths
- Immediately obvious what directory belongs to HOPS
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Complete homelab orchestration and provisioning system
- Support for 20+ popular homelab services
- Interactive installation with dependency resolution
- Security hardening and firewall configuration
- Service health monitoring and management interface
- Comprehensive error handling with rollback capabilities
- Complete uninstaller with data preservation options
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
Stephen Klein