selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

GitHub
arewedown logo

Self-host arewedown

0.3.0

Simple uptime monitoring dashboard for self-hosted services

BetaOpen SourceGPL-3.0
Updated3 years ago
LanguageJavaScript
Setup difficultyModerate
Stars
206
Port
3000 (HTTP dashboard and API)
Docker
shukriadams/arewedown
Install with Docker Compose
Are We Down? dashboard showing service status monitoring

What is arewedown?

Are We Down? is a lightweight uptime monitoring tool designed for home and self-hosting users who run multiple services on a private network. It provides a web-based dashboard to monitor HTTP endpoints, TCP ports, Docker containers, Jenkins jobs, systemd services, disk usage, ZFS pools, and custom scripts written in bash, Node.js, or Python. Alerts can be sent via SMTP email or Slack. The application runs as a Node.js server with no external database dependencies, and can be deployed via Docker, pre-built binaries, or from source. It supports x86 and ARM architectures including Raspberry Pi, and the dashboard works well in kiosk mode. The project has no built-in authentication and should not be exposed to the public internet.

Should you self-host arewedown?

arewedown scores 43/100 on selfhost.directory (how scoring works) and ranks #82 of 104 in Monitoring & observability. It has 206 GitHub stars.

There was no stable release in the past 12 months, so check the repository's recent activity before you rely on it.

Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is GPL-3.0-licensed and written mostly in JavaScript.

Its closest alternative on selfhost.directory is grafana (90/100, 77 568 stars). It scores higher overall, so compare the two before you pick. See arewedown vs grafana side by side.

Features

  • ARM and x86 support
  • Custom script tests
  • Dead man's switch (date in file)
  • Disk Usage Monitoring
  • HTTP uptime checks
  • Jenkins job monitoring
  • No Database Required
  • Ping Monitoring
  • Slack alerts
  • SMTP email alerts
  • Systemd service monitoring
  • TCP port monitoring
  • Web Dashboard
  • ZFS pool status monitoring

arewedown README

How to install arewedown

Install arewedown with Docker Compose

version: "2" services: arewedown: image: shukriadams/arewedown: container_name: arewedown restart: unless-stopped volumes: - ./config:/etc/arewedown/config - ./logs:/etc/arewedown/logs/:rw - ./queue:/etc/arewedown/queue/:rw # - ./scripts:/etc/arewedown/custom-tests # optional, see "custom tests" section of documentation ports: - "3000:3000"

Replace <TAG> with version tag (e.g., 0.2). Requires config and logs directories with write permissions for UID 1000.

How to configure arewedown

  • dashboardLoadTimeout5000Interval for dashboard timeout in milliseconds

    Interval for dashboard timeout in milliseconds

  • dashboardRefreshInterval5000Interval for dashboard refreshes in milliseconds

    Interval for dashboard refreshes in milliseconds

  • headerAre We Down?Default dashboard title

    Default dashboard title

  • internalWorkerTimer'0 0 * * *'Cron schedule for internal maintenance worker

    Cron schedule for internal maintenance worker

  • logLevelwarnAmount of data logged

    Amount of data logged

    values: error, warn, info

  • logRetention365Log retention in days

    Log retention in days

  • logs./logsDirectory where logs are written

    Directory where logs are written

  • port3000Port HTTP server runs on

    Port HTTP server runs on

  • recipientsAlert recipient definitions

    Alert recipient definitions

  • transportsAlert transport configurations (SMTP, Slack)

    Alert transport configurations (SMTP, Slack)

  • UIRestartfalseAllows app to be restarted from user interface

    Allows app to be restarted from user interface

    values: true, false

  • watchersService watcher definitions

    Service watcher definitions

arewedown releases & version history

More in Uptime Monitoring

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…