sync¶

vb sync [REMOTE] [OPTIONS]

Description¶

Synchronize all sharable changes between the local repository and a remote repository, with the remote provided as a URL or a configured remote name (see the remote command). Sharable changes include public check-ins and edits to wiki pages, tickets, forum posts, and technical notes.

If REMOTE is not specified, then the URL from the most recent clone, push, pull, remote, or sync command is used. See vb help clone for details on the URL formats.

Options¶

--all¶: Sync with all remotes, not just the default

-B, --httpauth USER:PASS¶: Credentials for the simple HTTP auth protocol, if required by the remote website

--ipv4¶: Use only IPv4, not IPv6

--no-http-compression¶: Do not compress HTTP traffic

--once¶: Do not remember URL for subsequent syncs

--proxy PROXY¶: Use the specified HTTP proxy

--private¶: Sync private branches too

-R, --repository REPO¶: Local repository to sync with

--ssl-identity FILE¶: Local SSL credentials, if requested by remote

--ssh-command SSH¶: Use SSH as the ssh command

--transport-command CMD¶: Use external command CMD to move message between the client and the server

-u, --unversioned¶: Also sync unversioned content

-v, --verbose¶: Additional (debugging) output - use twice to get network debug info

--verily¶: Exchange extra information with the remote to ensure no content is overlooked

Examples¶

Clone two repository with credentials

$ vb clone http://dev:devpass@127.0.0.1:8888 client_1.vbyte --save-http-password
Round-trips: 2   Artifacts sent: 0  received: 5 | 100% (5/5), 2.19 KiB | 39.88 KiB/s, done.        
Clone done, wire bytes sent: 588  received: 1658  remote: 127.0.0.1
Rebuilding repository meta-data...
  0.0% complete...
  33.3% complete...
  66.6% complete...
  100.0% complete...
Extra delta compression... none found
Vacuuming the database... 
project-id: 6117e4869f71a462ded154cebcc53e5d9b6064f6
server-id:  01298e66299d03409c0dd7aa9231f5399d0c1946
admin-user: dev (password is "G8Ash7BUdW")

$ vb clone http://dev:devpass@127.0.0.1:8888 client_2.vbyte --save-http-password
Round-trips: 2   Artifacts sent: 0  received: 5 | 100% (5/5), 2.20 KiB | 129.11 KiB/s, done.        
Clone done, wire bytes sent: 592  received: 1658  remote: 127.0.0.1
Rebuilding repository meta-data...
  0.0% complete...
  33.3% complete...
  66.6% complete...
  100.0% complete...
Extra delta compression... none found
Vacuuming the database... 
project-id: 6117e4869f71a462ded154cebcc53e5d9b6064f6
server-id:  e81db82d01ee6fe51212ea0ec2fdedeefe186d38
admin-user: dev (password is "cfvjCi9EV7")

Make a change and commit for client_1(it`s auto push to server)

$ vb commit -m "update"
Pull from http://dev@127.0.0.1:8888
Round-trips: 1   Artifacts sent: 0  received: 0 | 100% (0/0), 864.00 B | 8.52 KiB/s, done.        
Pull done, wire bytes sent: 436  received: 428  remote: 127.0.0.1
Committed version: fbc431ceb83077e4fc1993bcfe9ec81ad06c559eb207dd1073bd4b30381dd8fe
Sync with http://dev@127.0.0.1:8888
Round-trips: 1   Artifacts sent: 2  received: 0 | 100% (2/2), 1016.00 B | 14.81 KiB/s, done.        
Sync done, wire bytes sent: 715  received: 301  remote: 127.0.0.1

$ vb commit -m "update" --nosync -b dev
Committed version: 8127da79cc12c9cc9329890c997711991d02990cb077d3d3bd159cc4ecac33d5

Sync changes from client_2 to server

$ vb sync
Sync with http://dev@127.0.0.1:8888
Round-trips: 1   Artifacts sent: 2  received: 0 | 100% (2/2), 1.08 KiB | 16.83 KiB/s, done.        
Sync done, wire bytes sent: 802  received: 301  remote: 127.0.0.1

You can see client_1 changes in client_2 after sync from server

$ vb timeline
=== 2026-04-07 ===
06:51:42 [8127da79cc] *CURRENT* update (user: dev tags: dev)
06:51:41 [fbc431ceb8] update (user: dev tags: trunk)
06:51:41 [d57de8d24c] base (user: ubuntu tags: trunk)
06:51:40 [a88bd13d48] initial empty check-in (user: ubuntu tags: trunk)
+++ no more data (4) +++

sync¶

Description¶

Options¶

Examples¶

See Also¶