synology-dsm

Administer Synology NAS storage pools and btrfs filesystems over SSH.

2|Updated Apr 6, 2026
One-click install
npx skills add https://github.com/iuliandita/skills --skill synology-dsm
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: synology-dsm
Source: https://github.com/iuliandita/skills/tree/main/skills/synology-dsm
Command: npx skills add https://github.com/iuliandita/skills --skill synology-dsm

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill provides a safe, expert-level interface for managing Synology NAS appliances over SSH, preventing common catastrophic errors like volume destruction during btrfs repair or RAID assembly.

Core Features & Use Cases

  • Storage & Recovery: Safely diagnose and recover crashed btrfs volumes using dm-snapshot overlays and Synology-specific mount procedures.
  • System Administration: Manage packages, services, shares, and users while respecting DSM's unique configuration regeneration patterns.
  • Use Case: When a Synology volume reports as crashed or read-only, use this skill to identify the specific failure layer (RAID vs. LVM vs. btrfs) and perform a non-destructive recovery without triggering the common pitfalls that lead to permanent data loss.

Quick Start

Use the synology-dsm skill to identify the current DSM version and platform of the connected NAS.

Frequently Asked Questions about synology-dsm

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

FAQPage Schema
How do I recover a crashed Synology NAS volume without losing data?

Recovering a crashed Synology NAS volume involves diagnosing the failure layer across RAID, LVM, or btrfs, then applying non-destructive recovery techniques like dm-snapshot overlays to prevent permanent data loss.

Why does my Synology btrfs filesystem become read-only and how can I fix it?

A Synology btrfs filesystem enters a read-only state to protect data during corruption. Fixing it requires Synology-specific mount procedures and strict safety guardrails to avoid destructive btrfs repair operations.

How do I rebuild a degraded RAID array on a Synology NAS over SSH?

Rebuilding a degraded RAID array on a Synology NAS over SSH requires careful assembly commands that respect DSM's unique storage pool configurations to avoid volume destruction during the recovery process.

Can I repair a Synology btrfs filesystem without destroying the storage pool?

You can repair a Synology btrfs filesystem without destroying the storage pool by using dm-snapshot overlays that provide a safe, non-destructive isolation layer before attempting any filesystem repair operations.

Does managing Synology DSM packages over SSH risk breaking system configurations?

Managing Synology DSM packages over SSH can risk breaking system configurations if standard Linux methods are used, because DSM relies on unique configuration regeneration patterns that must be respected.

What are the limitations of using SSH to fix a crashed Synology DSM storage pool?

Limitations of fixing a crashed Synology DSM storage pool over SSH include the high risk of triggering permanent data loss if standard btrfs repair or RAID assembly commands bypass Synology-specific safety guardrails.