:abbr:`TFTP (Trivial File Transfer Protocol)` is a simple, lockstep file transfer protocol which allows a client to get a file from or put a file onto a remote host. One of its primary uses is in the early stages of nodes booting from a local area network. TFTP has been used for this application because it is very simple to implement.
.. cfgcmd:: set service tftp-server directory <directory> Enable TFTP service by specifying the `<directory>` which will be used to serve files.
Hint
Choose your directory location carefully or you will lose the
content on image upgrades. We preserve the contents of /config, so we
recommend using a directory there, for example /config/tftpboot.
.. cfgcmd:: set service tftp-server listen-address <address> Configure the IPv4 or IPv6 listen address of the TFTP server. Multiple IPv4 and IPv6 addresses can be given. There will be one TFTP server instances listening on each IP address.
.. cfgcmd:: set service tftp-server listen-address <address> vrf <name>
Additional option to run TFTP server in the :abbr:`VRF (Virtual Routing and Forwarding)` context
Note
Configuring a listen-address is essential for the service to work.
.. cfgcmd:: set service tftp-server allow-upload Optional, if you want to enable uploads, else TFTP server will act as a read-only server.
Provide TFTP server listening on both IPv4 and IPv6 addresses 192.0.2.1 and
2001:db8::1 serving the content from /config/tftpboot. Uploading via
TFTP to this server is disabled.
The resulting configuration will look like:
vyos@vyos# show service
tftp-server {
directory /config/tftpboot
listen-address 2001:db8::1
listen-address 192.0.2.1
}
Client:
vyos@RTR2:~$ tftp -p -l /config/config.boot -r backup 192.0.2.1
backup1 100% |******************************| 723 0:00:00 ETA
Server:
vyos@RTR1# ls -ltr /config/tftpboot/
total 1
-rw-rw-rw- 1 tftp tftp 1995 May 19 16:02 backup