# Nodes (VDS)

> Connect and manage Proxmox nodes for VPS / VDS virtualization.

## Identity

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

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

## Summary (for AI)

**Nodes (VDS)** Connect and manage Proxmox nodes for VPS / VDS virtualization. Requires permission `admin.nodes.view`. Key UI: Test connection; Edit VDS node; Confirm delete; Cancel; Delete VDS node.

## How to guide users

1. Open Admin sidebar.
2. Go to **Nodes (VDS)**.
3. Direct URL: `/admin/vds-nodes`.
4. User needs permission `admin.nodes.view` (or `admin.root`).

## Sections on this page

- What are VDS Nodes?
- How are they used?
- VPS Locations
- Proxmox Integration

## Notable UI actions / labels

- Test connection
- Edit VDS node
- Confirm delete
- Cancel
- Delete VDS node

## Widget slugs

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

## Related APIs / hooks

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

Hooks: `usePersistedListFilters`, `usePluginWidgets`