Skip to content

docs(tutorial): move volumes of installed apps - #300

Open
DavidePrincipi wants to merge 1 commit into
mainfrom
docs-volumectl-move-volume
Open

DavidePrincipi wants to merge 1 commit into
mainfrom
docs-volumectl-move-volume

Conversation

@DavidePrincipi

@DavidePrincipi DavidePrincipi commented Nov 12, 2026 •

Copy link
Copy Markdown
Member

The Disk usage tutorial said that moving the data of an installed application to another disk was a planned feature. The new volumectl move-volume command, implemented by NethServer/ns8-core#1399, adds it, so this PR replaces that note with the procedure. NethServer/dev#8259

Only the tutorial changes, in English and Italian. The new section continues the existing Mattermost example: copy the volume while the application runs, then complete the move with a short stop of the application. It also explains how to move a volume back to the root disk, what --force does, what happens on failure, and how to cancel a move.

  • New section "Move named volume data to another disk" (#move-volume) in docs/tutorial/disk_usage.md and its Italian mirror.
  • Links to it from the volume assignment note and from the "Migrate /home data to a new disk" section.

How to test

  1. Open the PR preview and read the Disk usage tutorial, in English and Italian.
  2. Follow the procedure on a node with an additional disk and check that the commands and paths match the real behavior.

See also


Generated by Claude Code:claude-haiku-5-5 with nethserver-pr

Replace the "planned feature" note with the procedure of the new
volumectl move-volume command: it moves one data volume of an
installed rootless application to another disk, with a copy step
that runs while the application works and a short final step.

Link the new section from the volume assignment note and from the
/home migration section, which is now a heavier alternative.

Assisted-by: Claude Code:claude-sonnet-5-5
@DavidePrincipi DavidePrincipi self-assigned this Nov 12, 2026
@github-actions

Copy link
Copy Markdown
Contributor
PR Preview Action v1.8.2

QR code for preview link

🚀 View preview at
https://NethServer.github.io/ns8-docs/pr-preview/pr-300/

Built to branch gh-pages at 2026-11-12 16:39 UTC.
Preview will be ready when the GitHub Pages deployment is complete.

@DavidePrincipi
DavidePrincipi marked this pull request as ready for review November 12, 2026 16:57

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants