Zebra Weblink Printer Setup Guide

There are two ways you can configure Zebra printers that are equipped with Weblink (almost all modern printers have Weblink).

The easiest way is to insert an USB stick with a predefined configuration.
The second method is by using a Telnet client.

After the printer restarts, you can add the printer with Serial and MAC Address like any other fixed reader.

Minimum firmware version

The minimum firmware version for Zebra Weblink to work reliably is Vxx.xx.10Z. You can check the firmware version on the printer's configuration label, through the printer's web interface, or by printing a configuration report (hold the FEED button for 2 seconds during power-up).

Configuration Mode

Testing - Minimal configuration for development and testing Production - Full hardening with security lockdowns

USB stick

Important: USB stick must be formatted to FAT32 for this to work.

The files you need to put on the USB stick can be downloaded in a zip file above. If you extract on a USB stick, the directory structure should be:

Directory structure:

[USB-CONFIG-DRIVE: U:\]

[U:/]
└── Zebra/
    ├── commands/
    │   └── configure.zpl
    └── files/
        ├── WEBLINK1_CA.NRD
        ├── WEBLINK1_CERT.NRD  (optional)
        └── WEBLINK1_KEY.NRD   (optional)

Configuration steps:

For the USB configuration to be applied correctly:

Perform a factory reset on the printer first

Insert the USB stick into the printer

Restart the printer with the USB stick plugged in

Wait for the printer to read the configuration and restart automatically

The printer will not apply configurations from the USB stick during normal operation — a restart with the USB stick inserted is required.

File contents

You can also construct the file structure manually with the following file contents, or download individual files:

configure.zpl Testing (download)


{}{"device.frontpanel.line1":"LabelCloud - ZTC ZD621-203dpi ZPL"}
{}{"device.frontpanel.line2":"Configuring ..."}
{}{"weblink.logging.max_entries":"250"}
{}{"weblink.ip.conn1.location":"https://labelcloud.bloodlab.org:443/weblink?access_key=05XjATFFNE6B4ssLkUbQjzIQnnLUywln6j4CLuP5Luo="}
{}{"ip.ntp.enable":"on"}
{}{"ip.ntp.servers":"pool.ntp.org time.google.com"}


{}{"device.frontpanel.line1":"LabelCloud - ZTC ZD621-203dpi ZPL"}
{}{"device.frontpanel.line2":"Configuring ..."}
{}{"ip.ntp.enable":"on"}
{}{"ip.ntp.servers":"pool.ntp.org time.google.com"}

{}{"device.command_override.active":"yes"}
{}{"device.command_override.add":"bluetooth.enable=lock"}
{}{"device.command_override.add":"mqtt.enable=lock"}
{}{"device.command_override.add":"usb.host.*=lock"}
{}{"device.command_override.add":"usb.mirror.*=lock"}

{}{"bluetooth.discoverable":"off"}
{}{"bluetooth.bonding":"off"}
{}{"bluetooth.enable_reconnect":"off"}
{}{"bluetooth.json_config_channel_enable":"off"}
{}{"bluetooth.sniff_mode_enable":"disabled"}
{}{"bluetooth.enable":"off"}

{}{"mqtt.enable":"off"}

{}{"usb.host.config_info_to_usb":"off"}
{}{"usb.host.keyboard_input":"off"}
{}{"usb.mirror.auto":"off"}
{}{"usb.mirror.enable":"off"}

{}{"weblink.cloud_connect.enable":"off"}
{}{"weblink.ip.conn1.test.test_on":"off"}
{}{"weblink.ip.conn2.test.test_on":"off"}
{}{"weblink.zebra_connector.enable":"off"}
{}{"weblink.logging.max_entries":"250"}
{}{"weblink.logging.clear":""}
{}{"weblink.ip.conn1.location":"https://labelcloud.bloodlab.org:443/weblink?access_key=05XjATFFNE6B4ssLkUbQjzIQnnLUywln6j4CLuP5Luo="}
{}{"weblink.ip.conn1.retry_interval":"300"}
{}{"weblink.ip.conn1.retry_interval_random_max":"60"}

{}{"device.reset":""}

WEBLINK1_CA.NRD (download)

Telnet client

It is also possible to configure the printer remotely by using Telnet. Ensure you have a Telnet client available. You can either use the built-in Telnet client or use a third party client like Putty.

Open a connection to the printer using your Telnet client.

Telnet connect:

telnet <ipaddress> 9100

Once connected to the printer, copy the contents of both files listed below into your Telnet client.

The first file named WEBLINK1_CA.NRD contains the commands to create a certificate file on the printer.
The second file named configure.zpl contains the ZPL commands to connect the printer to LabelCloud.

Important: After sending both files via Telnet, you must manually restart the printer for the configuration to take effect. The printer will not automatically reboot after receiving Telnet commands.

WEBLINK1_CA.NRD (for Telnet):

configure.zpl (for Telnet): Testing


{}{"device.frontpanel.line1":"LabelCloud - ZTC ZD621-203dpi ZPL"}
{}{"device.frontpanel.line2":"Configuring ..."}
{}{"weblink.logging.max_entries":"250"}
{}{"weblink.ip.conn1.location":"https://labelcloud.bloodlab.org:443/weblink?access_key=05XjATFFNE6B4ssLkUbQjzIQnnLUywln6j4CLuP5Luo="}
{}{"ip.ntp.enable":"on"}
{}{"ip.ntp.servers":"pool.ntp.org time.google.com"}


{}{"device.frontpanel.line1":"LabelCloud - ZTC ZD621-203dpi ZPL"}
{}{"device.frontpanel.line2":"Configuring ..."}
{}{"ip.ntp.enable":"on"}
{}{"ip.ntp.servers":"pool.ntp.org time.google.com"}

{}{"device.command_override.active":"yes"}
{}{"device.command_override.add":"bluetooth.enable=lock"}
{}{"device.command_override.add":"mqtt.enable=lock"}
{}{"device.command_override.add":"usb.host.*=lock"}
{}{"device.command_override.add":"usb.mirror.*=lock"}

{}{"bluetooth.discoverable":"off"}
{}{"bluetooth.bonding":"off"}
{}{"bluetooth.enable_reconnect":"off"}
{}{"bluetooth.json_config_channel_enable":"off"}
{}{"bluetooth.sniff_mode_enable":"disabled"}
{}{"bluetooth.enable":"off"}

{}{"mqtt.enable":"off"}

{}{"usb.host.config_info_to_usb":"off"}
{}{"usb.host.keyboard_input":"off"}
{}{"usb.mirror.auto":"off"}
{}{"usb.mirror.enable":"off"}

{}{"weblink.cloud_connect.enable":"off"}
{}{"weblink.ip.conn1.test.test_on":"off"}
{}{"weblink.ip.conn2.test.test_on":"off"}
{}{"weblink.zebra_connector.enable":"off"}
{}{"weblink.logging.max_entries":"250"}
{}{"weblink.logging.clear":""}
{}{"weblink.ip.conn1.location":"https://labelcloud.bloodlab.org:443/weblink?access_key=05XjATFFNE6B4ssLkUbQjzIQnnLUywln6j4CLuP5Luo="}
{}{"weblink.ip.conn1.retry_interval":"300"}
{}{"weblink.ip.conn1.retry_interval_random_max":"60"}

{}{"device.reset":""}