{"id":28493057,"url":"https://github.com/hhftechnology/media-server","last_synced_at":"2025-07-08T05:30:37.072Z","repository":{"id":269798527,"uuid":"907288641","full_name":"hhftechnology/media-server","owner":"hhftechnology","description":"An automated installation script for setting up a complete media server stack on Linux systems","archived":false,"fork":false,"pushed_at":"2024-12-26T07:56:04.000Z","size":36,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-06-08T09:07:21.454Z","etag":null,"topics":["bazarr","flaresolverr","jackett","lidarr","overseerr","prowlarr","qbittorrent-nox","radarr","readarr","sonarr"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hhftechnology.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-12-23T08:52:08.000Z","updated_at":"2024-12-26T07:56:07.000Z","dependencies_parsed_at":"2024-12-26T08:29:44.084Z","dependency_job_id":"e758430b-4b1f-41cb-9642-11f1334b39d0","html_url":"https://github.com/hhftechnology/media-server","commit_stats":null,"previous_names":["hhftechnology/media-server"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/hhftechnology/media-server","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hhftechnology%2Fmedia-server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hhftechnology%2Fmedia-server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hhftechnology%2Fmedia-server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hhftechnology%2Fmedia-server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hhftechnology","download_url":"https://codeload.github.com/hhftechnology/media-server/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hhftechnology%2Fmedia-server/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":264200723,"owners_count":23571826,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bazarr","flaresolverr","jackett","lidarr","overseerr","prowlarr","qbittorrent-nox","radarr","readarr","sonarr"],"created_at":"2025-06-08T09:07:23.170Z","updated_at":"2025-07-08T05:30:37.067Z","avatar_url":"https://github.com/hhftechnology.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# HHFTechnology Media Server Installation Script\n\nAn automated installation script for setting up a complete media server stack on Linux systems. This script simplifies the installation and configuration of popular media management applications.\n\n# ⚠️ Important Cautions\n\n- **Limited RAM Systems**: If your system has limited RAM (less than 4GB), install applications one by one rather than all at once to prevent system instability.\n\n- **Beta Features**: FlareSolverr and Overseerr integrations are currently in testing phase. Use these features at your own risk as they may contain bugs or unexpected behavior.\n\n## 🚀 Features\n\n- One-click installation of multiple media server applications\n- Automatic service configuration and management\n- Secure default settings\n- User and group permission management\n- Systematic backup and restore functionality\n- Interactive menu interface\n- Comprehensive logging\n- Error handling and recovery\n- System compatibility checks\n\n## 📋 Included Applications\n\n| Application | Description | Default Port |\n|-------------|-------------|--------------|\n| Jackett | Index aggregator/proxy | 9117 |\n| Sonarr | TV series management | 8989 |\n| Radarr | Movie management | 7878 |\n| Lidarr | Music management | 8686 |\n| Readarr | Book management | 8787 |\n| Prowlarr | Index manager | 9696 |\n| Bazarr | Subtitle management | 6767 |\n| qBittorrent-nox | Torrent client (headless) | 8080 |\n| FlareSolverr | Cloudflare bypass | 8191 |\n| Overseerr | Request management | 5055 |\n\n## 💻 System Requirements\n\n- Debian-based Linux distribution (Ubuntu, Debian, etc.)\n- Root/sudo access\n- Supported architectures:\n  - x86_64 (AMD64)\n  - aarch64 (ARM64)\n  - armv7l (ARM32)\n- Minimum 2GB RAM\n- 20GB available disk space\n\n## 🔧 Installation\n\n### Quick Install\n\n```bash\n# Download the installer\nwget -O - https://raw.githubusercontent.com/hhftechnology/media-server/main/get-hhf-installer.sh | sudo bash\n\n# Run the installation script\nsudo hhf-media-install\n```\n\n### Manual Installation\n\n1. Clone the repository:\n```bash\ngit clone https://github.com/hhftechnology/media-server.git\n```\n\n2. Make the script executable:\n```bash\nchmod +x get-hhf-installer.sh\n```\n\n3. Run the installer:\n```bash\nsudo ./get-hhf-installer.sh\n```\n\n## 📚 Usage\n\nThe installation script provides an interactive menu with the following options:\n\n### Installation Options\n- Install ALL applications\n- Individual application installation\n- Custom installation combinations\n\n### Removal Options\n- Remove ALL applications\n- Individual application removal\n- Clean uninstallation with configuration removal\n\n### Maintenance Options\n- Show active services\n- Display default ports\n- Show application sources\n- System status monitoring\n- Backup management\n- Restore from backup\n\n### Other Options\n- Script updates\n- Exit\n\n## 🛠️ Configuration\n\nDefault installation paths:\n- Application binaries: `/opt/\u003cApplicationName\u003e`\n- Configuration files: `/var/lib/\u003capplication\u003e/.config/\u003cApplicationName\u003e`\n- Download directory (qBittorrent): `/var/lib/qbittorrent-nox/Downloads`\n\nDefault credentials:\n- qBittorrent WebUI: \n  - Username: `admin`\n  - Password: `adminadmin`\n\n## 🔒 Security\n\nThe script implements several security measures:\n- Creates dedicated service users for each application\n- Establishes a media group for shared access\n- Sets appropriate file permissions\n- Uses systemd service isolation\n- Configures secure default settings\n\n## 📝 Logging\n\n- Installation logs: `/var/lib/hhf-installer/install.log`\n- State tracking: `/var/lib/hhf-installer/install_state`\n- Backup directory: `/var/lib/hhf-installer/backups`\n\n## 🔄 Backup and Restore\n\n### Creating Backups\nThe script automatically creates backups before major operations. Manual backups can be created through the maintenance menu.\n\n### Restoring from Backup\nUse the maintenance menu to restore from the most recent backup or specify a particular backup to restore.\n\n## 🐛 Troubleshooting\n\nCommon issues and solutions:\n\n1. **Service fails to start**\n   - Check logs: `journalctl -u \u003cservice-name\u003e`\n   - Verify permissions: `ls -l /opt/\u003cApplicationName\u003e`\n   - Ensure ports are available: `netstat -tulpn`\n\n2. **Permission Issues**\n   - Verify user/group membership\n   - Check directory permissions\n   - Review service user settings\n\n3. **Network Access**\n   - Confirm port availability\n   - Check firewall settings\n   - Verify network connectivity\n\n## 📄 License\n\nThis project is licensed under the MIT License - see the LICENSE file for details.\n\n## 🤝 Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n1. Fork the repository\n2. Create your feature branch (`git checkout -b feature/AmazingFeature`)\n3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)\n4. Push to the branch (`git push origin feature/AmazingFeature`)\n5. Open a Pull Request\n\n## 📮 Support\n\nIf you encounter any issues or have questions:\n\n1. Check the [Troubleshooting](#-troubleshooting) section\n2. Review the installation logs\n3. Open an issue on GitHub\n4. Join our community discussions\n\n## 🙏 Acknowledgments\n\n- Thanks to all the amazing projects that make this media server stack possible\n- Community contributors and testers\n- Open source software maintainers\n\n## ⚠️ Disclaimer\n\nThis script is provided as-is. Always review scripts before running them with root privileges. Users are responsible for complying with all applicable laws and regulations regarding media consumption and distribution.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhhftechnology%2Fmedia-server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhhftechnology%2Fmedia-server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhhftechnology%2Fmedia-server/lists"}