pct-restore

restores an LXC container from a Proxmox backup file

TLDR

Restore container from backup

$ pct restore [VMID] [/path/to/backup.tar.zst]

Restore with specific storage

$ pct restore [VMID] [backup.tar.zst] --storage [local-lvm]

Restore without starting

$ pct restore [VMID] [backup.tar.zst] --start 0

Restore with new hostname

$ pct restore [VMID] [backup.tar.zst] --hostname [newname]

Restore unprivileged

$ pct restore [VMID] [backup.tar.zst] --unprivileged 1

SYNOPSIS

pct restore vmid backup [options]

DESCRIPTION

pct restore restores an LXC container from a Proxmox backup file. It can restore to a new VMID, different storage, or with modified settings.

PARAMETERS

vmid

New container ID.

backup

Backup file path.

--storage name

Target storage.

--hostname name

Set hostname.

--start bool

Start after restore.

--unprivileged bool

Unprivileged container.

--rootfs spec

Root filesystem spec (e.g., local-lvm:20 for 20GB).

--memory MB

Set container memory limit.

--pool name

Add the container to the specified resource pool.

--force bool

Allow overwriting existing container.

--ignore-unpack-errors bool

Ignore errors during backup unpacking.

EXAMPLE

$ # Restore to container 200
pct restore 200 /var/lib/vz/dump/vzdump-lxc-100.tar.zst

# Restore with 20GB disk
pct restore 200 backup.tar.zst --rootfs local-lvm:20

CAVEATS

VMID must not exist. Storage must have space. Network config may need adjustment.

HISTORY

pct restore is part of Proxmox VE's backup and restore infrastructure, working with vzdump backups.