Configure IPP
Last Updated: April 07, 2026
Some cloud-enabled Enterprise Resource Planning (ERP) / Materials Requirements Planning (MRP) solutions print via the Internet Printing Protocol (IPP). Our Vasion Output solution supports the ingestion of print jobs into Vasion Output using IPP or IPPS protocols.
Requirements
- The IPP Connector supports the API Print Service.
-
You must have a functional Service Client that meets the minimum required specifications. See Service Client Setup.
Running IPv6 on your Windows Service Client may cause conflicts. You may need to disable IPv6 on the Service Client's network adapter to resolve the conflict.
-
Your Service Client must be able to access the following service URLs adjusted for your region.
https://agent-api.app.printercloud.com.https://agent-api-grpc.app.printercloud.com.ofn.app.printercloud.com.ofn-gw.app.printercloud.com.
- Have a certificate signed by a Certificate of Authority (CA) A trusted entity that issues Secure Sockets Layer (SSL) certificates. The main goal of a CA is to verify the authenticity and trustworthiness of a website, domain and organization so users know exactly who they're communicating with online and whether that entity can be trusted with their data. trusted by the source application submitting the job via IPP / IPPS.
- Source application must be able to reach the Service Client over its assigned IPP port; the default is 631.
Ubuntu Service Client
Customers with an Ubuntu (LTS) 22.04 Service Client must run an additional command on the Service Client after configuring the steps below. The command initializes the service.
sudo ln -s "$(cat /etc/pl_dir)/service_client/service-output-management/bin/libmako-adapter-lib.so" "$(cat /etc/pl_dir)/service_interface/lib/libmako-adapter-lib.so" Enable IPP(S) Service
- In the Admin Console, select the Service Client the will run the service.
- Select the Output Automation tab.
-
Enter the Domain Name of the Service Client you are using for Vasion Output.
This Domain Name must match the device certificate name and the Service Client must map this Domain Name to its local IP address. If this field is empty, the service will fail to start, and adds a "Failed to get host address" to the log.
-
Scroll down to the API & IPP Print Service section and select Enable IPP(S) Service.
-
The default port is 631, but you can change this, if necessary.
-
- Select Save.
Certificate
You only need to employ a certificate trusted by the source application if you use IPPS. Follow the steps below:
-
Select Enable TLS on IPP(S) Service.
-
Enter the information for your certificate using one of the following options:
-
Path to Certificate — enter the file path to where your .pem and .key files are stored on the Service Client.
-
Enter Certificate — paste the contents of the certificate and key files into the corresponding text boxes.
-
The Status section displays a green circle and states the service is Online when everything is configured correctly.
Optional Next Step
Troubleshooting Help
In some setups, external applications may need to reach the Vasion OutputService Client using a DNS name that resolves to an external IP address. However, this can cause issues the following issues:
- The Service Client cannot resolve the DNS name to its internal IP address.
- External DNS resolution conflicts with internal requirements.
Check if the Service Client can resolve the DNS name to its internal IP address. If the DNS name doesn't resolve correctly, you may need to modify the hosts file. See Troubleshoot DNS Resolution for Output Automation-Service Client
Ensure that the DNS name in the UI matches the one in the certificate used by the Service Client.