Admin9705
dcee82748b
- Update Python version from 3.9/3.10 to 3.12 across all platforms - Upgrade Flask from 3.0.0 to 3.1.2 - Upgrade requests from 2.31.0 to 2.32.5 - Upgrade waitress from 2.1.2 to 3.0.2 - Upgrade pyyaml from 6.0 to 6.0.2 - Update documentation to reflect Python 3.12+ requirement - Update GitHub Actions workflows for macOS (ARM/Intel) and Windows - Update Dockerfile base image to python:3.12-slim - Update Windows setup script to require Python 3.12+ This addresses CVE's in requests and waitress, and ensures compatibility with Python 3.12 which provides improved performance and security.
2.5 KiB
Huntarr.io macOS Installer Guide
Overview
Huntarr.io now provides native macOS installers alongside the primary Docker deployment method. The macOS installers are automatically built and published through GitHub Actions whenever changes are pushed to the repository.
Available Installers
Two types of macOS installers are generated:
- Intel (x86_64) - For Intel-based Macs
- ARM (arm64) - For Apple Silicon Macs (M1, M2, etc.)
Installation
- Download the appropriate installer package (.pkg) for your Mac from the GitHub Releases page.
- Double-click the downloaded .pkg file to start the installation process.
- Follow the on-screen instructions to complete the installation.
- The application will be installed in your
/Applicationsfolder.
Configuration
When first launched, Huntarr.io will create the necessary configuration directories:
~/Library/Application Support/Huntarr/config/
├── logs/
├── settings/
├── stateful/
└── user/
This structure mirrors the Docker container's /config directory structure.
Differences from Docker Version
The macOS application functions similarly to the Docker version with a few key differences:
- Data is stored in the user's Application Support folder instead of a Docker volume
- The app runs as a native macOS application rather than in a container
- System requirements are tied to macOS version and architecture rather than Docker
Troubleshooting
If you encounter issues:
- Check the logs database at
~/Library/Application Support/Huntarr/config/logs.db - Ensure proper permissions for the application folders
- Verify your macOS version is compatible (macOS 10.15 Catalina or newer recommended)
Notes
- The Docker version remains the primary supported deployment method
- The macOS version is provided as a convenience for users who prefer native applications
- Both Intel and ARM versions are built with the same codebase but optimized for each architecture
Build Process
The macOS installers are built automatically using GitHub Actions with the following process:
- Python 3.12 environment is set up on a macOS runner
- The Huntarr.io icon is converted to macOS .icns format
- PyInstaller bundles the application into a native macOS .app
- A PKG installer is created using macOS pkgbuild
- The installer is uploaded as an artifact and attached to GitHub releases
The build process handles both Intel (x86_64) and ARM (arm64) architectures separately to ensure optimal performance on each platform.