Skip to content

feat: add resize disk guide #3539

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 2 commits into
base: master
Choose a base branch
from
Open

Conversation

Sonichigo
Copy link

Documentation Update:

This pull request introduces a new documentation page to guide users on resizing the disk size of a Lima VM running on macOS. The guide provides a step-by-step process, including prerequisites, commands for successful resizing.

Issue resolve: #3418

Signed-off-by: Animesh Pathak <[email protected]>
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The file name should be disk.md and should cover other disk operations too

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

gotcha! I'll rename and add other options too. Also in this case it make sense to include both the Linux and MacOS instructions, (previous assumption was only for MacOS)

@AkihiroSuda AkihiroSuda added the documentation Improvements or additions to documentation label May 14, 2025
1. Sufficient free disk space on your host.
2. Using `Qemu` VM type for the lima.

## Steps to Resize Lima VM Disk
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@Sonichigo
Copy link
Author

@AkihiroSuda i have made the necessary changes, but since i primarily use qemu type vm and have more clarity modified the flow accordingly. With VZ, by experience is very limited, so feel free on feedback if there's something i missed.

@@ -0,0 +1,72 @@
---
title: Resize Disk Size
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
title: Resize Disk Size
title: Disks


## Option 1: Resize Disk Using limactl

Lima supports editing the disk size of an existing instance using the `--disk` flag with the `limactl edit` command.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Lima supports editing the disk size of an existing instance using the `--disk` flag with the `limactl edit` command.
Starting with v1.1, Lima supports editing the disk size of an existing instance using the `--disk` flag with the `limactl edit` command.

> - Increasing disk size is supported, but shrinking disks is not recommended.
> - The instance may need to be stopped before editing disk size.

## Option 2: Manually Resize Lima VM Disk
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This shouldn't be needed

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please squash the commits

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation
Projects
None yet
Development

Successfully merging this pull request may close these issues.

document how to increase disk size
2 participants