# Create VDS Instance

> Provision a new VPS from a node, template, and resources.

## Identity

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

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

## Summary (for AI)

**Create VDS Instance** Provision a new VPS from a node, template, and resources. Under sidebar item “Virtual Servers (VDS)”. Requires permission `admin.nodes.view`. Key UI: Node & template; Choose a node and template; Resources; CPU, memory, disk, and network; Details & owner; Hostname and assign owner.

## How to guide users

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

## Sections on this page

_None extracted._

## Notable UI actions / labels

- Node & template
- Choose a node and template
- Resources
- CPU, memory, disk, and network
- Details & owner
- Hostname and assign owner
- Review & create
- Confirm the configuration before creating the VDS
- Backup retention
- Backup limit
- Cloud-init user
- Cloud-init password

## Widget slugs

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

## Related APIs / hooks

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

Hooks: `usePluginWidgets`