# Edit instance

> Update hostname, notes, owner, IP, resources, and disks.

## Identity

| Field | Value |
| --- | --- |
| Route | `/admin/vm-instances/[id]/edit` |
| Area | admin |
| Audience | Panel administrators (requires admin permissions) |
| Component | `VmInstanceEditPage` |
| Source | `src/app/(app)/admin/vm-instances/[id]/edit/page.tsx` |
| Dynamic | yes |
| Params | `id` |
| Title i18n key | `admin.vmInstances.edit` |
| Description i18n key | `admin.vmInstances.edit_desc` |
| Permission | `admin.nodes.view` |
| Nav group | `infrastructure` |
| Sidebar label | Virtual Servers (VDS) |

## Summary (for AI)

**Edit instance** Update hostname, notes, owner, IP, resources, and disks. Under sidebar item “Virtual Servers (VDS)”. Requires permission `admin.nodes.view`. Key UI: Details; Network; Resources; Disks; Task history; VDS suspension active.

## How to guide users

1. Open Admin sidebar.
2. Open **Virtual Servers (VDS)** (parent nav item), then **Edit instance**.
3. Direct URL: `/admin/vm-instances/[id]/edit`.
4. Replace path params `id` with the real resource id(s).
5. User needs permission `admin.nodes.view` (or `admin.root`).

## Sections on this page

_None extracted._

## Notable UI actions / labels

- Details
- Network
- Resources
- Disks
- Task history
- VDS suspension active
- Suspend VDS instance?

## Widget slugs

- [`admin-vm-instance-edit`](../widgets/admin-vm-instance-edit.md)

## Related APIs / hooks

- `/api/admin/users`

Hooks: `usePluginWidgets`
