{"id":22295520,"url":"https://github.com/mrodrig/firewalla-apcupsd","last_synced_at":"2025-07-29T01:32:12.581Z","repository":{"id":55854950,"uuid":"319828879","full_name":"mrodrig/firewalla-apcupsd","owner":"mrodrig","description":"Firewalla Scripts for APC UPS Daemon","archived":false,"fork":false,"pushed_at":"2020-12-13T02:03:46.000Z","size":17,"stargazers_count":12,"open_issues_count":0,"forks_count":2,"subscribers_count":4,"default_branch":"master","last_synced_at":"2024-04-14T22:06:41.914Z","etag":null,"topics":["apc","apcupsd","battery","firewalla","firewalla-apcupsd","firewalla-gold","firewalla-scripts","ups"],"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/mrodrig.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-12-09T03:18:57.000Z","updated_at":"2023-09-08T02:03:37.000Z","dependencies_parsed_at":"2022-08-15T07:51:07.370Z","dependency_job_id":null,"html_url":"https://github.com/mrodrig/firewalla-apcupsd","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mrodrig%2Ffirewalla-apcupsd","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mrodrig%2Ffirewalla-apcupsd/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mrodrig%2Ffirewalla-apcupsd/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mrodrig%2Ffirewalla-apcupsd/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mrodrig","download_url":"https://codeload.github.com/mrodrig/firewalla-apcupsd/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":227966748,"owners_count":17848657,"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":["apc","apcupsd","battery","firewalla","firewalla-apcupsd","firewalla-gold","firewalla-scripts","ups"],"created_at":"2024-12-03T17:42:24.125Z","updated_at":"2024-12-03T17:42:24.907Z","avatar_url":"https://github.com/mrodrig.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# firewalla-apcupsd\n\n## What is this project?\n\nThis project is intended to provide a customized script that's compatible with\nFirewalla Gold units that allows you to easily integrate an APC UPS device for\nbattery backup and surge protection in the event of a less than ideal power\nsituation.\n\nNote that this project is not officially supported by either Firewalla or APC\nand is provided free of charge as open source software. Firewalla, APC, and the\ncontributors of this package provide no guarantees of compatibility or any other\nwarranty if you choose to use this software on your Firewalla Gold unit.\n\n## Installation\n\n```bash\n# SSH into your Firewalla Gold (specify your network gateway IP)\n# Note: Please verify that SSH is enabled for your particular network\nssh pi@192.168.100.1 # eg. for a 192.168.100.1/24 network\n# Enter password from Firewalla app --\u003e Settings --\u003e Advanced --\u003e Configurations --\u003e SSH Console --\u003e Tap password to reveal\n\n# Clone the repository on your Firewalla Gold\ngit clone https://github.com/mrodrig/firewalla-apcupsd.git\n\n# Navigate into the cloned directory and ensure the scripts are executable\ncd firewalla-apcupsd\nchmod +x *.sh\n\n# Install the firewalla-apcupsd.conf script into the Firewalla custom scripts directory\n./install.sh\n\n# Run the installation script to ensure APCUPSD is installed.\n./firewalla-apcupsd.sh\n\n# Done!\n```\n\n## How does this work?\n\nThis script leverages Firewalla's [Customized Scripting](https://help.firewalla.com/hc/en-us/articles/360054056754--Firewalla-Gold-Customized-Scripting-)\nfunctionality to provide a persistent UPS package installation and configuration\non your Firewalla Gold unit. This package will use a default configuration, as\nspecified in the `firewalla-apcupsd.sh` script so you may need to customize it\nbefore running `install.sh` depending on your specific UPS. The settings that\nwere specified were for the Back-UPS 1000VA 600W unit that I purchased\n(Model Number: BX1000M-LM60) for use with my network equipment.\n\nEssentially the `install.sh` script will copy the `firewalla-apcupsd.sh` script\nand the `apcupsd.conf` configuration file over to\n`/home/pi/.firewalla/config/post_main.d` where Firewalla allows custom scripts\nto be stored so that whenever your Firewalla Gold is restarted or updated your\nFirewalla Gold will not lose your APC UPS configuration or connection. Without\nthis custom script and configuration, your Firewalla Gold effectively uninstalls\nthe `apcupsd` package that's required to integrate with an APC UPS system at\nevery reboot, causing the UPS to simply run until the battery is completely\ndepleted, and therefore decreasing the life of the UPS' battery.\n\nCurrently this project does not support running custom scripts when different\npower events are reported by the UPS, but I am open to pull requests to add\nsupport for that functionality and good documentation around the configuration\nand usage of the feature.\n\n## Contributing\n\nSince everyone's configuration is different, I'm open to pull requests that\nimprove the script logic, performance, and reliability, but will likely not\nmerge any PRs seek to adjust the configuration specified in this project, unless\nit is in response to an `apcupsd` package update on the Firewalla Gold unit.\n\n## FAQ\n\nQ: What is the runtime of your 1000VA 600W UPS?\n\nA: On average, the display and command line show anywhere between 140-160 minutes of runtime depending on system load, but usually hovering around 146 minutes. This includes power for my Firewalla Gold, Verizon FiOS ONT network box, Netgear GS308E managed switch, ActionTec ECB6200 MoCA Adaptor, T-Mobile Line Link, and a 5V fan which is being used to provide cooling for the Firewalla Gold.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmrodrig%2Ffirewalla-apcupsd","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmrodrig%2Ffirewalla-apcupsd","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmrodrig%2Ffirewalla-apcupsd/lists"}