پرش به محتوا
مارکت محصولات دیجیتال و خدمات توسعه
خانهپروژه‌هاLinuxCare-App
</>
Open Source Project

LinuxCare-App

MilMit/LinuxCare-App

Native Linux maintenance, diagnostics, health intelligence, and GNOME integration built with Rust, GTK4, and Libadwaita.

★ 0Stars
⑂ 0Forks
0Open Issues
0Watchers
Rustزبان اصلی
License
README

مستندات مخزن

LinuxCare logo

LinuxCare

Safety-first Linux maintenance, diagnostics, health intelligence, and GNOME integration — built natively with Rust, GTK4, and Libadwaita.

CI Security Release Ubuntu / GNOME Rust 1.93 Status: Public Beta

⬇ Download .deb  •  All release assets  •  Release notes

Public Beta

LinuxCare 0.7.0-beta.1 is the first public Beta of LinuxCare. The feature set is frozen for this release line while testing focuses on package reliability, upgrade safety, privilege separation, compatibility, and real-world bug fixing.

Important

This is Beta software. Review proposed maintenance actions before applying them, keep normal backups, and report reproducible issues with sanitized logs.

Download

Recommended package for Ubuntu/GNOME:

Download linuxcare_0.7.0-beta.1_amd64.deb

All release artifacts, source archives, checksums, SBOM, and release metadata are available on the v0.7.0-beta.1 release page.

Install

After downloading the Debian package:

sudo apt install ./linuxcare_0.7.0-beta.1_amd64.deb

Launch from the GNOME application menu or run:

linuxcare

Verify the package

Download SHA256SUMS.txt alongside the .deb, then run:

grep 'linuxcare_0.7.0-beta.1_amd64.deb' SHA256SUMS.txt | sha256sum -c -

For the complete verification procedure, see VERIFY_RELEASE.md.

What LinuxCare does

AreaCapabilities
VitalsLive CPU, RAM, temperature, network, battery, historical trends, and process intelligence
Smart CleanerRisk-aware cleanup, Safety Quarantine, Undo, retention limits, and truthful freed-space accounting
Health IntelligenceExplainable Health Score 2.0, Maintenance Center recommendations, and local “What Changed?” baselines
System DoctorsBoot, Service, Package, Filesystem, Thermal & Power, Battery, Hardware, and Storage diagnostics
NetworkRoute/DNS/interface diagnostics, listener context, socket ownership, firewall context, and explicit active probes
StorageStorage Analyzer, Storage Runway, cleanup growth intelligence, guarded filesystem throughput benchmark, and container storage analysis
HardwareDMI/CPU/GPU/storage inventory plus explicit authenticated read-only SMART/NVMe health checks
AutomationUser-level systemd maintenance timers with safe unprivileged modes and optional desktop notifications
GNOMELinuxCare Vitals top-bar extension with compact live metrics and power-profile integration

Safety model

LinuxCare is intentionally designed so the GTK application does not run as root.

System-level operations pass through a narrow D-Bus helper protected by Polkit. The helper exposes fixed typed operations rather than a generic privileged shell. LinuxCare does not use generic pkexec, sh -c, or bash -c execution for maintenance actions.

Additional safety rules include:

  • User-space cleanup eligible for Undo is moved into same-filesystem Safety Quarantine.
  • Quarantined bytes are not counted as freed disk space until permanent purge.
  • Scheduled maintenance remains unprivileged and does not silently run privileged APT, Snap, Flatpak, journal, firewall, SMART mutation, or package-removal operations.
  • Unknown or unavailable diagnostic data is not silently converted into a healthy zero.
  • Network listeners are reported as exposure context, not automatically labelled Internet-public.
  • SMART/NVMe checks are explicit, read-only, device-validated, and return normalized health data instead of arbitrary root command output.
  • Deep Network does not persist remote endpoint history or capture packet payloads.

See ARCHITECTURE.md and SECURITY.md for the deeper design and privilege-boundary documentation.

GNOME Shell extension

The included extension is LinuxCare Vitals with UUID:

linuxcare-vitals@milmit.net

The packaged metadata currently declares GNOME Shell versions 45–50.

Check and enable it with:

gnome-extensions info linuxcare-vitals@milmit.net
gnome-extensions enable linuxcare-vitals@milmit.net

If GNOME has just installed the extension and it is not visible yet, log out and back in once.

Beta verification

The public Beta has passed the project release gates used for this build, including:

  • Rust formatting and native dependency preflight.
  • cargo check.
  • Clippy with warnings denied.
  • Unit tests.
  • Development and optimized release builds.
  • Static/security regression checks.
  • Desktop, AppStream, GNOME, D-Bus, Polkit, and package metadata validation.
  • Isolated 1024×600 GUI startup smoke.
  • Staged install / upgrade / uninstall lifecycle testing.
  • Real Debian install / legacy-upgrade / remove smoke testing on Ubuntu.
  • Deterministic release packaging, SHA-256 checksums, release manifest, and SPDX 2.3 SBOM generation.

Primary CI runs on Ubuntu 24.04 with Rust 1.93, with an MSRV gate on Rust 1.92. See .github/workflows/ci.yml for the current automated matrix.

Build from source

Install the native development dependencies on Ubuntu:

sudo apt update
sudo apt install -y 
  build-essential pkg-config 
  libgtk-4-dev libadwaita-1-dev libgraphene-1.0-dev 
  desktop-file-utils appstream shellcheck xvfb dbus-x11

Use the pinned Rust toolchain and build the workspace:

rustup toolchain install 1.93.0 --component rustfmt clippy
cargo +1.93.0 build --release --workspace

Run the full project verification gate:

./scripts/beta-gate.sh

Build the Debian package:

./scripts/build-deb.sh

Optional runtime integrations

LinuxCare remains useful when optional tools are absent, but some diagnostics become richer when these are available:

  • smartmontools — authenticated SMART/NVMe health.
  • libnotify-bin — desktop notification delivery.
  • bpftool — richer eBPF readiness diagnostics; this Beta does not attach BPF programs.
  • gnome-extensions — explicit LinuxCare Vitals enable/disable management.

Screenshots

Real application screenshots are intentionally not fabricated. The repository currently contains the screenshot capture checklist and validation manifest under assets/screenshots/. Privacy-reviewed screenshots from the actual Beta UI will be added there for README/AppStream presentation.

Known Beta limitations

  • Per-process network bandwidth is intentionally unavailable until a real eBPF/cgroup accounting backend exists.
  • SMART/NVMe health is read-only; LinuxCare does not run self-tests, firmware updates, sanitize, or format operations.
  • Container reclaimable-space values are estimates and may differ from actual freed bytes because of shared layers and active references.
  • Storage Runway needs enough local history before it can forecast capacity pressure.
  • Data protected by Safety Quarantine still occupies disk space until purge.
  • The Full Edition currently depends on host Polkit/D-Bus/systemd integration; the development Snap definition should not be treated as equivalent to the verified Debian package without separate confinement/store review.

Documentation

Reporting bugs

Use GitHub Issues and include:

  • LinuxCare version.
  • Ubuntu and GNOME versions.
  • Clear reproduction steps.
  • Expected and actual behavior.
  • Sanitized logs only when useful.

Do not post passwords, authentication tokens, private file contents, unrelated personal paths, or sensitive endpoint data.

Licensing

The repository currently does not declare an open-source license. Do not assume public source availability grants redistribution or relicensing rights. Licensing/distribution policy will be finalized separately from the Beta verification status.


LinuxCare — maintain Linux with evidence, explicit boundaries, and reversible actions where reversal is real.
Created by Milad Dadgar and published by MilMit.