# VDS Instances

> Manage all VDS/VPS instances in your system.

## Identity

| Field | Value |
| --- | --- |
| Route | `/admin/vm-instances` |
| Area | admin |
| Audience | Panel administrators (requires admin permissions) |
| Component | `VmInstancesPage` |
| Source | `src/app/(app)/admin/vm-instances/page.tsx` |
| Dynamic | no |

| Title i18n key | `admin.vmInstances.title` |
| Description i18n key | `admin.vmInstances.description` |
| Permission | `admin.nodes.view` |
| Nav group | `infrastructure` |
| Sidebar label | Virtual Servers (VDS) |

## Summary (for AI)

**VDS Instances** Manage all VDS/VPS instances in your system. Sidebar label: “Virtual Servers (VDS)”. Requires permission `admin.nodes.view`. Key UI: Create VDS Instance; Create your first VDS instance to get started; View details; Edit; Delete; VMID:.

## How to guide users

1. Open Admin sidebar.
2. Open **Virtual Servers (VDS)**, then **VDS Instances**.
3. Direct URL: `/admin/vm-instances`.
4. User needs permission `admin.nodes.view` (or `admin.root`).

## Sections on this page

- Managing VDS Instances
- Resources & Configuration
- Tips
- VDS Instance Details

## Notable UI actions / labels

- Create VDS Instance
- Create your first VDS instance to get started
- View details
- Edit
- Delete
- VMID:
- Hostname:
- IP Address:
- Status:
- Created:
- Owner:
- Owner Email:

## Widget slugs

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

## Related APIs / hooks

- `/api/admin/users`
- `/api/admin/vm-instances`
- `/api/admin/vm-nodes`

Hooks: `usePersistedListFilters`, `usePluginWidgets`