Skip to main content
Version: v4.18


Loads bytes from and saves bytes to a UDP socket.



udp [-c|--connect] [-n|--insert-newlines] <endpoint>


udp <endpoint>


The udp connector supports UDP sockets. The loader reads blocks of bytes from the socket, and the saver writes them to the socket.

The loader defaults to creating a socket in listening mode. Use --connect if the loader should initiate the connection instead.

When you have a socket in listening mode, use to accept connections on all interfaces. The nics operator lists all all available interfaces.


The address of the remote endpoint to connect to when using --connect, and the bind address when using --listen.

-c,--connect (Loader)

Connect to <endpoint> instead of listening at it.

-n,--insert-newlines (Saver, Loader)

Append a newline character (\n) at the end of every datagram.

This option comes in handy in combination with line-based parsers downstream, such as NDJSON.


Import JSON via UDP by listenting on IP address at port 56789:

from udp://
| import

Use a shell to test the UDP loader with netcat:

Shell 1
tenzir 'from udp://'
Shell 2
jq -n '{foo: 42}' | nc -u 56789

Send the Tenzir version as CSV file to a remote endpoint via UDP:

| write csv
| save udp

Use nc -ul 56789 to spin up a UDP server to test the above pipeline.