PHPackages                             scherhak/uplinkr - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Logging &amp; Monitoring](/categories/logging)
4. /
5. scherhak/uplinkr

ActiveLibrary[Logging &amp; Monitoring](/categories/logging)

scherhak/uplinkr
================

A lightweight, file-based Laravel package for monitoring website availability with zero external dependencies.

v0.3.0(2mo ago)320↓50%1MITPHPPHP ^8.2CI passing

Since Feb 4Pushed 2mo ago1 watchersCompare

[ Source](https://github.com/scherhak/uplinkr)[ Packagist](https://packagist.org/packages/scherhak/uplinkr)[ Docs](https://uplinkr.dev)[ RSS](/packages/scherhak-uplinkr/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (6)Dependencies (8)Versions (14)Used By (1)

 [![Uplinkr Logo](.github/uplinkr-mascot-200.png)](.github/uplinkr-mascot-200.png)

Uplinkr
=======

[](#uplinkr)

 CLI-first monitoring for Laravel — simple, local, reliable.
 File-based monitoring for URLs &amp; APIs. No external services.

 [ ![tests](https://github.com/scherhak/uplinkr/actions/workflows/tests.yml/badge.svg) ](https://github.com/scherhak/uplinkr/actions/workflows/tests.yml) [ ![Latest Stable Version](https://camo.githubusercontent.com/7e4e76afb69456579b3de92f5ea9270a845b7b003f05b0d534e70a8aeba85030/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f736368657268616b2f75706c696e6b72) ](https://packagist.org/packages/scherhak/uplinkr) [ ![Total Downloads](https://camo.githubusercontent.com/22ee99ec6a988016fedae2b70015048b0900bfe25f08d87e2268105a3dc4f9b3/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f736368657268616b2f75706c696e6b72) ](https://packagist.org/packages/scherhak/uplinkr) [ ![License](https://camo.githubusercontent.com/e539038504c2662209a3f940a7fa20df3167349f09950f285e2948cf541659d0/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f736368657268616b2f75706c696e6b72) ](https://packagist.org/packages/scherhak/uplinkr)

What is Uplinkr?
----------------

[](#what-is-uplinkr)

**Uplinkr** is a lightweight, file-based uptime and response monitoring package for Laravel. It allows you to monitor your URLs and APIs without requiring a database, storing all probe results as JSON files. Perfect for developers who need simple, reliable monitoring integrated directly into their Laravel applications.

Key Features
------------

[](#key-features)

- **File-Based Storage** - No database required, all data stored as JSON files
- **Native Laravel Integration** - Built specifically for Laravel with Artisan commands
- **Automatic Scheduler Integration** - Run probes automatically with Laravel's task scheduler
- **Project Organization** - Group related probes together in projects
- **Global + Project Settings** - Separate global `uplinkr/settings.json` and per-project `settings.json`
- **Customizable Thresholds** - Define acceptable response times and failure tolerances
- **Multiple Notification Channels** - Log, email, and webhook support out of the box
- **I’m Alive Heartbeats** - Global heartbeat notifications with configurable interval and channels

How It Works
------------

[](#how-it-works)

Uplinkr follows a simple workflow:

1. **Create a Project** - Organize your monitoring targets into logical groups
2. **Add Probes** - Define URLs/APIs to monitor with optional custom headers, methods, and body data
3. **Configure Alerts** - Set up failure thresholds and notification channels
4. **Run Probes** - Execute manually or automatically via Laravel's scheduler
5. **Receive Alerts** - Get notified when probes fail or respond slowly
6. **Send Heartbeats** - Keep operators informed that monitoring is active via I’m alive

All probe results and settings are stored as JSON files, making it easy to inspect, back up, and track operational changes over time.

Quick Start
-----------

[](#quick-start)

This section walks you through the minimal setup required to start monitoring a URL or API. No database, no external services — just install, configure, and run your first probe.

#### 1. Install Uplinkr via Composer

[](#1-install-uplinkr-via-composer)

```
composer require scherhak/uplinkr
```

#### 2. Publish Configuration Files

[](#2-publish-configuration-files)

```
php artisan uplinkr:install
```

#### 3. Create your first project

[](#3-create-your-first-project)

```
php artisan uplinkr:project:init --project=my-project
```

#### 4. Add the simplest check

[](#4-add-the-simplest-check)

```
php artisan uplinkr:project:add:probe --project=my-site --url=https://example.com
```

#### 5. Run the check for your first project

[](#5-run-the-check-for-your-first-project)

```
php artisan uplinkr:project:run-probes
```

Deep Dive
---------

[](#deep-dive)

Want to go beyond the basics?

- **Full documentation:** Complete reference, concepts, and architecture overview.
- **Getting started guide:**
    Step-by-step setup with explanations and best practices.

Requirements
------------

[](#requirements)

- **PHP:** 8.2 or higher
- **Laravel:** 11.x or 12.x
- **PHP extension:** `ext-openssl` (required for TLS certificate metadata)

Contributing
------------

[](#contributing)

Contributions are welcome! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for details.

Security
--------

[](#security)

If you discover any security related issues, please see [SECURITY.md](SECURITY.md) for how to report them.

License
-------

[](#license)

MIT License. See [LICENSE.md](LICENSE.md).

###  Health Score

40

—

FairBetter than 88% of packages

Maintenance86

Actively maintained with recent releases

Popularity12

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity44

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~7 days

Total

6

Last Release

68d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/e2c5275bc26a4bb04783e158177f94d268e3eac607b18fddec2aa452078b1505?d=identicon)[scherhak](/maintainers/scherhak)

---

Top Contributors

[![scherhak](https://avatars.githubusercontent.com/u/4221861?v=4)](https://github.com/scherhak "scherhak (114 commits)")

---

Tags

api-monitoringartisanclifile-basedhealth-checkshealth-checks-apijsonlaravellaravel-packagemonitoringphpscheduleuptimeurlfilesystemlaravelmonitoringstatusuptimeprobe

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/scherhak-uplinkr/health.svg)

```
[![Health](https://phpackages.com/badges/scherhak-uplinkr/health.svg)](https://phpackages.com/packages/scherhak-uplinkr)
```

###  Alternatives

[spatie/laravel-health

Monitor the health of a Laravel application

86910.0M83](/packages/spatie-laravel-health)[inspector-apm/inspector-laravel

Code Execution Monitoring, built for developers.

2332.0M2](/packages/inspector-apm-inspector-laravel)[yadahan/laravel-authentication-log

Laravel Authentication Log provides authentication logger and notification for Laravel.

416632.8k5](/packages/yadahan-laravel-authentication-log)[kssadi/log-tracker

A powerful, intuitive, and efficient log viewer for Laravel applications.

264.8k](/packages/kssadi-log-tracker)[appkeep/laravel-appkeep

Instantly discover problems with your Laravel sites.

124.6k](/packages/appkeep-laravel-appkeep)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
