--- title: "Proxmox" slug: "proxmox" tags: ["7.12", "Edge Filer", "Gateway", "Filer"] updated: 2026-09-01T14:15:34Z published: 2026-09-01T14:15:34Z canonical: "kb.ctera.com/proxmox" --- > ## Documentation Index > Fetch the complete documentation index at: https://kb.ctera.com/llms.txt > Use this file to discover all available pages before exploring further. # Proxmox ## Installing the CTERA Edge Filer in a Proxmox Environment Installing the CTERA Edge Filer involves creating and configuring a virtual machine and then performing an initial configuration, described in [First Time Setup](/v1/docs/first-time-setup-4-1-1-1-1). Contact CTERA, and request the latest qcow2 CTERA Edge Filer disk image. **Warning** The CTERA Edge Filer installation must be done using the qcow2 file and not by cloning an existing CTERA Edge Filer. **To install the edge filer:** 1. Log in to the Proxmox console. ![Image](https://cdn.document360.io/30792387-cdcb-4791-aa14-94929bbcd3fe/Images/Documentation/image-Z0PBWH3Z.png?sv=2026-02-06&spr=https&st=2026-11-11T04%3A27%3A31Z&se=2026-11-11T05%3A27%3A31Z&sr=c&sp=r&sig=juhawhUYssbTmhe9oQrM6iCUVhaEZWE1EI8zR2DJ6O8%3D) The dashboard is displayed. 2. Select the datacenter node and click **Shell**. ![Image](https://cdn.document360.io/30792387-cdcb-4791-aa14-94929bbcd3fe/Images/Documentation/image-8VS7YBJA.png?sv=2026-02-06&spr=https&st=2026-11-11T04%3A27%3A31Z&se=2026-11-11T05%3A27%3A31Z&sr=c&sp=r&sig=juhawhUYssbTmhe9oQrM6iCUVhaEZWE1EI8zR2DJ6O8%3D) 3. Run the following command to create the CTERA Edge Filer image directory in Proxmox: `mkdir /var/lib/vz/images/ctera-edgefiler` 4. Copy the edge filer qcow2 image to the `/var/lib/vz/images/ctera-edgefiler` directory. You can use a tool like WinSCP to copy the file. ![Image](https://cdn.document360.io/30792387-cdcb-4791-aa14-94929bbcd3fe/Images/Documentation/image-Y9GA8SOG.png?sv=2026-02-06&spr=https&st=2026-11-11T04%3A27%3A31Z&se=2026-11-11T05%3A27%3A31Z&sr=c&sp=r&sig=juhawhUYssbTmhe9oQrM6iCUVhaEZWE1EI8zR2DJ6O8%3D) 5. Click **Create VM**. The **Create: Virtual Machine** window is displayed. ![Image](https://cdn.document360.io/30792387-cdcb-4791-aa14-94929bbcd3fe/Images/Documentation/image-N36Q81J2.png?sv=2026-02-06&spr=https&st=2026-11-11T04%3A27%3A31Z&se=2026-11-11T05%3A27%3A31Z&sr=c&sp=r&sig=juhawhUYssbTmhe9oQrM6iCUVhaEZWE1EI8zR2DJ6O8%3D) 6. Enter a unique name to identify this edge filer in the **Name** field and click **Next**. ![Image](https://cdn.document360.io/30792387-cdcb-4791-aa14-94929bbcd3fe/Images/Documentation/image-NUZYY6S6.png?sv=2026-02-06&spr=https&st=2026-11-11T04%3A27%3A31Z&se=2026-11-11T05%3A27%3A31Z&sr=c&sp=r&sig=juhawhUYssbTmhe9oQrM6iCUVhaEZWE1EI8zR2DJ6O8%3D) 7. Select the **Do not use any media** option and click **Next** until you display the **Disks** tab. ![Image](https://cdn.document360.io/30792387-cdcb-4791-aa14-94929bbcd3fe/Images/Documentation/image-SUFWLOC4.png?sv=2026-02-06&spr=https&st=2026-11-11T04%3A27%3A31Z&se=2026-11-11T05%3A27%3A31Z&sr=c&sp=r&sig=juhawhUYssbTmhe9oQrM6iCUVhaEZWE1EI8zR2DJ6O8%3D) 8. Click **Add**. **SCSI1** is added to the list. ![Image](https://cdn.document360.io/30792387-cdcb-4791-aa14-94929bbcd3fe/Images/Documentation/image-EJRNH615.png?sv=2026-02-06&spr=https&st=2026-11-11T04%3A27%3A31Z&se=2026-11-11T05%3A27%3A31Z&sr=c&sp=r&sig=juhawhUYssbTmhe9oQrM6iCUVhaEZWE1EI8zR2DJ6O8%3D) 9. Select **SCSI1** and then select the storage from the **Storage** list. 10. Specify the disk size. 11. Click **Next** or the **CPU** tab. ![Image](https://cdn.document360.io/30792387-cdcb-4791-aa14-94929bbcd3fe/Images/Documentation/image-YOBCBY4P.png?sv=2026-02-06&spr=https&st=2026-11-11T04%3A27%3A31Z&se=2026-11-11T05%3A27%3A31Z&sr=c&sp=r&sig=juhawhUYssbTmhe9oQrM6iCUVhaEZWE1EI8zR2DJ6O8%3D) 12. Specify the number of vCPUs. The recommended vCPUs is the license number/4. For example, 8 vCPUs for an edge filer with an EV32 license. The vCPUs is the number you specify for **Sockets** multiplierd by the number of **Cores**. **Note** Check **Advanced** to see the vCPUs. ![Image](https://cdn.document360.io/30792387-cdcb-4791-aa14-94929bbcd3fe/Images/Documentation/image-H2IVEVF7.png?sv=2026-02-06&spr=https&st=2026-11-11T04%3A27%3A31Z&se=2026-11-11T05%3A27%3A31Z&sr=c&sp=r&sig=juhawhUYssbTmhe9oQrM6iCUVhaEZWE1EI8zR2DJ6O8%3D) 13. Click **Next**. ![Image](https://cdn.document360.io/30792387-cdcb-4791-aa14-94929bbcd3fe/Images/Documentation/image-T2C4N1E0.png?sv=2026-02-06&spr=https&st=2026-11-11T04%3A27%3A31Z&se=2026-11-11T05%3A27%3A31Z&sr=c&sp=r&sig=juhawhUYssbTmhe9oQrM6iCUVhaEZWE1EI8zR2DJ6O8%3D) 14. Enter the RAM amount in the **Memory (MiB)** field. The minimum RAM requirement is 8192MB (8GB). CTERA recommends that the amount of RAM is the license number/2. For example, specify 16384MB (16GB) for an edge filer with an EV32 license. 15. Click the **Next** until you display the **Confirm** tab. ![Image](https://cdn.document360.io/30792387-cdcb-4791-aa14-94929bbcd3fe/Images/Documentation/image-9A64QO85.png?sv=2026-02-06&spr=https&st=2026-11-11T04%3A27%3A31Z&se=2026-11-11T05%3A27%3A31Z&sr=c&sp=r&sig=juhawhUYssbTmhe9oQrM6iCUVhaEZWE1EI8zR2DJ6O8%3D) 16. Review the details and then click **Finish**. 17. Select the datacenter node and click **Shell**. 18. Run the following commands: ``` qm importdisk vmid /var/lib/vz/images/ctera-edgefiler/file.qcow2 storage qm set vmid --scsihw virtio-scsi-pci --scsi0 storage:vm-vmid-disk-1 ``` Where: *vmid* is the edge filer VM id, such as `103` *file* is the CTERA Edge Filer image. For example, `vGateway-version.qcow2` where *version* is the version number of the edge filer. The value is case sensitive. That is, for example, `vGateway-7.12.54000.20.qcow2` and **not** `vgateway-7.12.54000.20.qcow2` *storage* is the name of the storage. The VM image is overwritten with the edge filer image. `storage:vm-vmid-disk-1s` is the disk name specified at the end of the `importdisk` command. ![Image](https://cdn.document360.io/30792387-cdcb-4791-aa14-94929bbcd3fe/Images/Documentation/image-HAEQQV6S.png?sv=2026-02-06&spr=https&st=2026-11-11T04%3A27%3A31Z&se=2026-11-11T05%3A27%3A31Z&sr=c&sp=r&sig=juhawhUYssbTmhe9oQrM6iCUVhaEZWE1EI8zR2DJ6O8%3D) 19. Right-click the VM in the navigation pane and click **Start**. The VM is powered on and the **Console** option is enabled. 20. Click **Console**. ![Image](https://cdn.document360.io/30792387-cdcb-4791-aa14-94929bbcd3fe/Images/Documentation/image-723CY60G.png?sv=2026-02-06&spr=https&st=2026-11-11T04%3A27%3A31Z&se=2026-11-11T05%3A27%3A31Z&sr=c&sp=r&sig=juhawhUYssbTmhe9oQrM6iCUVhaEZWE1EI8zR2DJ6O8%3D) 21. Login in with the username `setup` and no password, as instructed. Using DHCP, after a few seconds, the IP address to access the CTERA Edge Filer is displayed in the top right of the console. ![Image](https://cdn.document360.io/30792387-cdcb-4791-aa14-94929bbcd3fe/Images/Documentation/image-AI80B4ZX.png?sv=2026-02-06&spr=https&st=2026-11-11T04%3A27%3A31Z&se=2026-11-11T05%3A27%3A31Z&sr=c&sp=r&sig=juhawhUYssbTmhe9oQrM6iCUVhaEZWE1EI8zR2DJ6O8%3D) Otherwise, set a static IP address, as described below. 22. Continue with [First Time Setup](/v1/docs/first-time-setup-4-1-1-1-1). ## Setting a Static IP Address If you did not customize the template to set the static IP address during the installation, you can set it from the virtual machine. **To set the virtual machine static IP address:** 1. Access the virtual machine. 2. Select **Console** The following login screen is displayed: ![Image](https://cdn.document360.io/30792387-cdcb-4791-aa14-94929bbcd3fe/Images/Documentation/image-723CY60G.png?sv=2026-02-06&spr=https&st=2026-11-11T04%3A27%3A31Z&se=2026-11-11T05%3A27%3A31Z&sr=c&sp=r&sig=juhawhUYssbTmhe9oQrM6iCUVhaEZWE1EI8zR2DJ6O8%3D) 3. Login in with the username `setup` and no password, as instructed. Using DHCP, after a few seconds, the IP address to access the CTERA Edge Filer is displayed in the top right of the console. ![Image](https://cdn.document360.io/30792387-cdcb-4791-aa14-94929bbcd3fe/Images/Documentation/image-AI80B4ZX.png?sv=2026-02-06&spr=https&st=2026-11-11T04%3A27%3A31Z&se=2026-11-11T05%3A27%3A31Z&sr=c&sp=r&sig=juhawhUYssbTmhe9oQrM6iCUVhaEZWE1EI8zR2DJ6O8%3D) 4. Click in the console to transfer the keyboard control to the console and, if necessary, use the arrow keys to scroll to **Network settings**. 5. Press **Enter**. ![Image](https://cdn.document360.io/30792387-cdcb-4791-aa14-94929bbcd3fe/Images/Documentation/image-WUOWJFI2.png?sv=2026-02-06&spr=https&st=2026-11-11T04%3A27%3A31Z&se=2026-11-11T05%3A27%3A31Z&sr=c&sp=r&sig=juhawhUYssbTmhe9oQrM6iCUVhaEZWE1EI8zR2DJ6O8%3D) 6. Select **Static IP mode** and press **OK**. 7. Complete the configuration for static mode by entering the static IP, netmask, default CTERA Edge Filer IP and the primary and secondary DNS server IPs. 8. Press **OK**.