Verified and Tested 10/02/2015
Rsync is a great way to synchronize files between servers or to simply move files between servers without the need of FTP. It connects two servers via the SSH protocol, allowing for the transfer of data between them. The rsync daemon, covered later in this article, uses its own protocol and runs on a specified port. Below we’ll go over the basics; copying between servers, copying to/from rsync daemons, and keeping files in sync with each other on different servers.
– 2 Linux servers that both have rsync installed.
– The server doing the initiating of the transfer needs to be able to access the receiving server’s SSH port (or rsync port, if connecting to an rsync daemon).
– The user needs to have permissions to use rsync (the examples below will be run as the root user).
Basics of Rsync
Rsync can push files to another server or pull files from another server. The difference between the two is in the syntax. If you specify your local file first, it will initiate a push. If you specify your remote host first, it will initiate a pull. Let’s see the exact type of syntax below.
rsync [-options] SOURCE [email protected]:DESTINATION
rsync [-options] [email protected]:SOURCE DESTINATION
[-options] are all the different options that can be used. Some I’ll reference and explain in examples below. For a full list of all the options, review the manual page.
SOURCE stands for the
/directory/path/to/the/file/or/directory which will be copied.
DESTINATION stands for the
/directory/path/to/the/new/location on the receiving host.
[email protected] is the user on the remote host for rsync to connect with.
x.x.x.x stands for the IP address of the remote host. It can also be a hostname if you have DNS configured.
Now, say you need to specify a port outside of the default port 22 for rsync to connect to. You would do this with the option
-e. See the example below (replace
PORT with the port number you need to connect to).
rsync [-other options] -e 'ssh -p PORT' SOURCE [email protected]:DESTINATION
rsync [-other options] -e 'ssh -p PORT' [email protected]:SOURCE DESTINATION
Simple File Transfer Examples
First, we will initiate a push of a .txt file from one server to another.
rsync /home/simple.txt [email protected]:/home
This command will copy the file
simple.txt from our local server, to our remote server’s
Rsync Transfer between two servers.
On the right, we did an
ls before the rsync and then again after it was run, so we can see the file was copied.
Here is an example of a pull:
rsync [email protected]:/home/pullme.txt /home
pullme.txt is on the remote server (x.x.x.x) in the
/home directory. This command will copy the file to the local server’s
You can push/pull any single file you specify using this method. Now, let’s get into directories.
Directory File Transfer
Moving a directory is simple. Add the
-d option, and it will move only the directory. If you want to move the directory and its contents, use
-r instead to recursively copy over all files and subfolders. While we’re at it, let’s tack on the
-t option. This option will copy the date and time that the file was last changed. Using
-t is good for keeping accurate records of when a file was last edited. These options will work with pushing or pulling.
In the below example, I have moved the
pullme.txt file into a
/transfer_me directory. I have also created the directory
/simple (which contains the file
/transfer_me. I then pushed the
/transfer_me directory to the remote server.
rsync -rt /home/transfer_me [email protected]:/home
As you can see, the folder on the remote (receiving) server contains all the subdirectories and files that the local folder did on the initiating server.
Connecting to an Rsync Daemon
This section requires a server running an rsync daemon. To test these instructions out, see our article on setting up an rsync daemon.
Now that we’ve gone over basic file/directory transferring with rsync, we can go over connecting to an rsync daemon. An rsync daemon is running constantly on a server so you can push to and/or pull from that server’s assigned rsync daemon directory at any time. There are two formats to pulling and pushing to an rsync daemon.
rsync [-options] rsync://[email protected][:PORT]SOURCE DESTINATION
Pull (note the double colons after the IP address/hostname):
rsync [-options] [email protected]::SOURCE DESTINATION
rsync [-options] SOURCE rsync://[email protected][:PORT]DESTINATION
Push (note the double colons after the IP address/hostname):
rsync [-options] SOURCE [email protected]::DESTINATION
See below how I pulled from the rsync daemon (the use of port number 873 below is redundant, since that’s the default rsync daemon connection port–I include it to demonstrate how you would format the command if you had set up a non-default port on your rsync daemon):
rsync -rt rsync://[email protected]:873/files/ /home/pulledfromdaemon
Rsync daemon pull
files is the module name. Since we’re pulling everything in that directory (
simple.txt) we simply leave it at the module name for the source.
Syncing Files with Rsync
Now we’ll discuss how to sync files. You can perform a sync with a single rsync command, with the right options. You can put this command in a script or cron job to run on demand or automatically. The command varies if you are pushing or pulling or using the daemon, but the options remain the same.
rsync -rtu --delete SOURCE [email protected]:/DESTINATION
In this example, pay attention to the
-rtu --delete options. We have already discussed the
-t options–recursive copy and time stamp copy. The
-u option tells rsync to update only different/changed/added files from the
SOURCE to the
DESTINATION. The option
--delete will remove any files from the
DESTINATION that the
SOURCE may no longer have. With this (and other options, like
-l for symlinks) you can keep directories in multiple locations up to date with the source.
You can now rsync files between servers, rsync daemons, and keep files synced with each other with ease. Thank you for following this how-to! Please check back here for more updates, or take a look at the many services we offer including HIPAA compliant cloud hosting.