rdk-system-maintain

Diagnoses and repairs apt sources, disk space, and filesystem expansion on D-Robotics RDK boards.

3|Updated Aug 6, 2026
One-click install
npx skills add https://github.com/D-Robotics/rdk-skills --skill rdk-system-maintain-d-robotics
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: rdk-system-maintain
Source: https://github.com/D-Robotics/rdk-skills/tree/main/skills/rdk-system-maintain
Command: npx skills add https://github.com/D-Robotics/rdk-skills --skill rdk-system-maintain-d-robotics

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? RDK boards accumulate day-2 maintenance issues: apt update fails against expired source domains, apt locks block package operations, TF-card filesystems stay unexpanded, and disks fill up. This Skill runs a read-only health check and applies official D-Robotics FAQ repair steps instead of guesswork. ## Core Features & Use Cases - Read-only health check: scripts/maintain_check.sh reports stale apt source domains, GPG key presence, apt/dpkg lock state, per-mount disk usage, and large cleanable directories as JSON. - Official repair procedures: Fixes expired archive.sunrisepi.tech domains per official FAQ Q10, handles apt locks in the documented wait/reboot/confirm order, and enforces the 1.x-to-2.x reflash constraint for system upgrades. - Storage management: Guides TF-card filesystem expansion via srpi-config and lists disk cleanup actions one by one for user confirmation. - Use Case: A user's apt update fails with "Could not resolve" on an RDK X5. The Skill runs the health check, detects the stale domain in sunrise.list, and applies the official sed/wget fix after confirmation. ## Quick Start Ask the agent to check why apt update is failing on your RDK board and repair the software sources using the official fix.

Frequently Asked Questions about rdk-system-maintain

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fix apt update failing with Could not resolve on RDK?▼

The apt source domain archive.sunrisepi.tech is expired. Per official FAQ Q10, replace it with archive.d-robotics.cc in /etc/apt/sources.list.d/sunrise.list using sed, fetch the sunrise.gpg key, then rerun apt update.

How to expand the filesystem on an RDK TF card?▼

Run sudo srpi-config, select Advanced Options, then Expand Filesystem, and reboot. This official procedure applies to RDK X3 and X5 series boards; S100 and Ultra boards are not supported.

Can I upgrade RDK OS from 1.x to 2.x with apt upgrade?▼

No. The official constraint states 1.x systems cannot be upgraded to 2.x or newer via apt; you must reflash a new system image. Within the same major version, sudo apt update && sudo apt upgrade works.

Is it safe to delete apt lock files when apt is stuck?▼

Only as a last resort. The official order is to wait for background updates, reboot, then confirm no apt/dpkg process is running before removing lock files. The Skill refuses to clean locks while a holder process exists.

What does the RDK maintenance health check script report?▼

It outputs JSON with board identity, apt source file presence and stale domains, GPG key status, apt lock state with holder PID, per-mount disk usage percentages, large cleanable directories, and the last apt update timestamp.