Installing and configuring CUPS in Proxmox


I have an old printer and I want to make it network discoverable. For this tutorial, you will need already running Proxmox server and a bit of know-how.

I am using VM instead of LXC because I’ve encountered some connection problems when passing the USB printer trough.


Installing Debian VM

Go to https://tteck.github.io/Proxmox/#debian-12-vm and copy the installation command.

Login into your Proxmox server and open shell on your node.

Paste the code in and press Enter. Now enter and select the following:

  1. “This will create a New Debian 12 VM. Proceed?” → Yes
  2. “Use Default Settings?” → Advanced
  3. “Set Virtual Machine ID” → Leave default
  4. “Choose Type” → Leave default
  5. “Disk cache” → Leave default
  6. “Set hostname” → “cups”
  7. “CPU Model” → Leave default
  8. “Allocate CPU Cores” → 1
  9. “Allocate RAM in MiB” → 1024
  10. “Set a Bridge” → Leave default
  11. “Set a MAC Address” → Leave default
  12. “Set a VLAN” → Leave blank
  13. “Set Interface MTU Size” → Leave blank
  14. “Start VM when completed?” → Yes
  15. “Ready to create a Debian 12 VM?” → Yes
  16. “Which storage pool you would like to use for cups?” → I assume you don’t have any other disks in your Proxmox server, so choose local-lvm (Press space bar to make selection, then tab and OK)

Now wait and don’t close the console.

If you did everything correctly, this should be the result.
And the machine ID should be in the “Server view” list


Making the disk size bigger

This part will be the tricky one. We need to extend the disk size from 2 GB to 8 GB. Unlike LXC container (where you add disk capacity in Proxmox UI), you will need to run some commands in the VM.

Click the VM in the server view list → Hardware → Select “Hard Disk” → Disk Action → Resize → Size Increment (GiB) → 6 → Resize Disk
Now the Hard Disk section should contain …,size=8G,…

Now we need to resize the disk in the actual VM. Press Console:

You should see prompt “root@localhost:~#”

Now list disks using fdisk:


If /dev/sda is 8 GB, good. (Ignore the red error for now, we will deal with that later)


Now update the repositories:

Install parted:

Now run parted:

Your shell should change to this:

Then type print (warning should pop up, type Fix). Take note of the ext4 partition (that is the root partition that we want to expand, for me, it is 1).

Type in this (replace the “1” with your partition number):

Accept the warning by typing Yes

Type in print again and check if the size changed. At the start of this step it was around 2000 MB now it changed to 8456 MB, so we successfully changed the size.


You can quit the parted shell by typing “quit”

Now reboot the VM by typing reboot:

Login again.

We are done resizing the disk!


Installing CUPS

(Finally) We are going to install CUPS and drivers for our printer.

Update system via:

Install CUPS and Splix (https://github.com/OpenPrinting/splix: drivers for old printers, if yours doesn’t work, you will need to find another one):

Then start CUPS.

Enable auto-start at boot time.

Check its status:

Output should look similar to this

Now we are going to edit the config file:

Here we need to modify a few things.

Find the following line:

Change it to:

Then find:

Change it to:

Then we need to make the web UI accessible only from LAN, find these lines:

And change them to this:

Now save and close the file. (Press CTRL + X, then Y, then Enter)

After these changes restart CUPS service:

Now create a user called cups (set the password to whatever you want):

Then add the “cups” user to “lpadmin” group:

Now we need to find out the local IP of our VM

Copy that IP, we will need it later.

Go back to Proxmox UI and click “Hardware”

  1. Connect your printer via USB to the Proxmox server
  2. Click Add
  3. Click USB Device
  4. “Use USB Vendor/Device ID” → Find your printer
  5. OK

Type the IP from earlier in your search bar:

  1. Click “Administration”
  2. Login your with your “cups” credentials → “Add Printer”
  3. Click on your printer from the list, click “Continue”
  4. Edit the details to your liking and check “Share This Printer”, click “Continue”
  5. Choose correct driver for the make of your printer, click “Continue”
  6. Click “Set default options
  7. Everything default should be correct, click “Set default options”

Now you are finished! Your old printer should be discoverable on your local network using IPP (Internet printing protocol).

I hope this guide helped you!