Self-hosted disk benchmark and health monitor.
Sectorama discovers your drives, runs comprehensive fio benchmarks (position curve + I/O profiles), polls SMART attributes on a schedule, and surfaces everything through a clean React dashboard — all from a single Docker container on your own hardware.

Dashboard showing 12 drives with live SMART health badges, temperatures, type, and capacity at a glance.

Historical speed curve to track performance overtime

Latency, sequential and random read statistics

• Drive discovery — auto-detects all block devices via smartctl --scan

• Position curve — measures sequential read speed at evenly-spaced byte offsets to visualise the speed falloff from outer to inner tracks. Sample parameters are drive-type aware: QD 32 / 256 MiB per sample on NVMe, QD 1 / 128 MiB on HDD and SATA SSD

• fio profiles — four uniform profiles per run, identical parameters on every drive type so results are directly comparable across devices:

  • Sequential read, 1 MiB blocks, QD 1 — single-stream throughput (typical NAS workload)
  • Sequential read, 1 MiB blocks, QD 32 — deep-queue throughput (saturates NVMe bandwidth)
  • Random read, 4 KiB blocks, QD 1 — latency-sensitive baseline
  • Random read, 4 KiB blocks, QD 32 — peak IOPS (matches CrystalDiskMark Q32T1)

  Each profile runs for 30 s (plus 5 s ramp) with O_DIRECT and a fixed random seed, pinned to a middle-of-disk region to eliminate outer-track bias. Latency percentiles (P50 / P95 / P99 / P99.9) are recorded per profile. All benchmark I/O is strictly read-only, and only one benchmark runs at a time so concurrent jobs can never distort each other's results

• SMART history — scheduled polling stored in InfluxDB; attribute trends charted over time

• Benchmark schedules — cron-based per-drive or global schedules

• Notifications — alert channels (Webhook, Slack) with per-alert-type subscriptions; transition-only firing (once on condition onset, silent until it clears and re-triggers); per-drive temperature threshold overrides

• Live feed — WebSocket push for real-time benchmark progress and health alerts

• Dark UI — React + Tailwind dashboard; fully responsive

curl -O https://raw.githubusercontent.com/tabilzad/sectorama/master/docker-compose.prod.yml

export INFLUXDB_TOKEN=change-me-strong-random-secret
# optional — defaults shown
export INFLUXDB_ADMIN_PASSWORD=adminpass
export SMART_POLL_INTERVAL_MINUTES=5
export BENCHMARK_NUM_POINTS=11

docker compose -f docker-compose.prod.yml up -d

Open http://localhost:8888, click Scan for Drives, then run a benchmark from any drive's detail page.

Note: The container runs privileged and mounts /dev read-only so that smartctl and fio can access raw block devices. Do not expose port 8888 to the public internet.

# 1. Clone
git clone https://github.com/tabilzad/sectorama.git
cd sectorama

# 2. Install workspace dependencies
npm install

# 3. Start just the InfluxDB 
docker compose -f docker-compose.dev.yml up -d

# 4. Configure environment for node
cp .env.example .env
# On Windows/macOS: add DISK_DISCOVERY_MOCK=true to .env

# 5. Run (backend :8888, frontend :5173 with HMR)
npm run dev

npm run build       # compiles shared → backend → frontend
npm run typecheck   # type-check all workspaces without emitting

Sectorama can push alerts to external services when a drive's health or temperature crosses a threshold.

Alerts are transition-only: they fire once when a condition first occurs and are silent until the condition clears and re-triggers. This prevents alert storms on every poll.

Channels are managed from the Notifications page in the UI. Each channel can subscribe to any combination of alert types. A test payload can be sent from the UI at any time.

The global default is set via TEMPERATURE_ALERT_THRESHOLD_CELSIUS (default 50°C). Individual drives can override this from the Alert Settings section on the Drive Detail → SMART tab.

1. Create packages/backend/src/services/notifications/channels/MyChannel.ts implementing INotificationChannel
2. Add a case 'mytype' to channelFactory.ts
3. Add the new ChannelType to @sectorama/shared

No other files need to change.

Contributions are welcome. Please:

1. Fork the repository and create a branch from master
2. Make your changes and verify npm run build && npm run typecheck pass
3. Open a pull request — CI will run automatically on the PR

For larger changes, open an issue first to discuss the approach.

Released under the GNU General Public License v3.0.