{"id":13550036,"url":"https://github.com/shukriadams/arewedown","last_synced_at":"2026-06-28T21:32:14.146Z","repository":{"id":50324065,"uuid":"198781614","full_name":"shukriadams/arewedown","owner":"shukriadams","description":"Simple, customizable HTTP uptime and status checking service.","archived":false,"fork":false,"pushed_at":"2023-08-29T16:43:46.000Z","size":1082,"stargazers_count":209,"open_issues_count":9,"forks_count":21,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-03-29T11:49:28.199Z","etag":null,"topics":["dashboard","docker","nodejs","self-hosted","uptime","uptime-monitor","uptime-robot"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/shukriadams.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"docs/contributing.md","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}},"created_at":"2019-07-25T07:34:46.000Z","updated_at":"2025-02-10T06:13:02.000Z","dependencies_parsed_at":"2024-01-16T18:23:52.562Z","dependency_job_id":null,"html_url":"https://github.com/shukriadams/arewedown","commit_stats":null,"previous_names":[],"tags_count":25,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shukriadams%2Farewedown","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shukriadams%2Farewedown/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shukriadams%2Farewedown/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shukriadams%2Farewedown/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/shukriadams","download_url":"https://codeload.github.com/shukriadams/arewedown/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246911058,"owners_count":20853652,"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":["dashboard","docker","nodejs","self-hosted","uptime","uptime-monitor","uptime-robot"],"created_at":"2024-08-01T12:01:28.306Z","updated_at":"2026-06-28T21:32:14.135Z","avatar_url":"https://github.com/shukriadams.png","language":"JavaScript","funding_links":[],"categories":["JavaScript"],"sub_categories":[],"readme":"![Screenshot of AreWeDown?](https://github.com/shukriadams/arewedown/blob/master/screenshot.PNG)\r\n\r\n*Are We Down?* is a simple uptime monitoring system and dashboard. It is ideal for the home/self-hosting user who runs multiple services/networked devices on a private LAN, and who doesn't want the complexity of an enterprise-level monitoring system. It lets you turn any HTTP endpoint into a status indicator. SSH into things and test that way. Gather all your tests into a single or multiple dashboards. And it's easy to set up.\r\n\r\n[![codecov](https://codecov.io/gh/shukriadams/arewedown/branch/develop/graph/badge.svg?token=DXO5XYWW2T)](https://codecov.io/gh/shukriadams/arewedown)\r\n\r\n## Features \r\n\r\n- Simple to configure with just a few lines of text in a single YML file.\r\n- No databases or dependencies on other services.\r\n- Does HTTP status checks, ssh, ping, Docker container status and more. \r\n- Sends alerts via email (SMTP) and Slack.\r\n- Can be extended with your own test scripts using shell scripts, Javascript (NodeJS) or Python3 scripts.\r\n- Runs on x86 and ARM (Docker images available for the Raspberry Pi 3 or better).\r\n- Built-in dashboard will run on almost any browser, ideal for a Raspberry Pi in kiosk mode. \r\n\r\n*NOTE:* *Are We Down?* has no built-in security, never expose it to the public internet. It is perfectly safe running behind a trusted firewall/router, that is what it was intended for. \r\n\r\n## Install options\r\n\r\n- [Docker](/docs/install-docker.md) - Linux x64 + ARMv7.\r\n\r\n- [Binaries](/docs/install-binaries.md) - Linux + Windows x64 (these are still experimental).\r\n\r\n- [NodeJS source](/docs/install-nodejs.md) - any OS that supports NodeJS 12.x or better.\r\n\r\n## Config\r\n\r\nThe most basic setup of *Are We Down?* can be done with only\r\n\r\n    watchers:\r\n        mysite:\r\n            host: http://mysite.example.com\r\n\r\nThis sets up a single watcher that scans the given domain every minute for HTTP status 200, and displays this on a dashboard. See [settings](/docs/settings.md) for details.\r\n\r\n### Transports\r\n\r\nAlerts can be sent with the following methods :\r\n\r\n- SMTP (good old email)\r\n- Slack\r\n\r\n### Watchers\r\n\r\nThe following built-in tests are available :\r\n\r\n- HTTP status\r\n- TCP port open\r\n- Docker container up\r\n- Jenkins job passing\r\n- System.d process status\r\n\r\n### Custom tests\r\n\r\nIn addition to using built-in tests, you can also write tests in bash, NodeJS or Python3 if you're more into that sort of thing. For details see [custom code tests](/docs/custom-tests.md).\r\n\r\n## Interested in contributing?\r\n\r\nSee [contributing](/docs/contributing.md) if you'd like to improve this project.\r\n\r\n## License\r\n\r\n*AreWeDown?* is available under the [GPL3.0 license](https://github.com/shukriadams/arewedown/blob/master/LICENSE).\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fshukriadams%2Farewedown","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fshukriadams%2Farewedown","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fshukriadams%2Farewedown/lists"}