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.20 KiB | 75.88 KiB/s, done.        
Clone done, wire bytes sent: 591  received: 1663  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: a502fb1868cc5d7269d092b7f004f641b851d52c
server-id:  3039d92cfc9fae1cae363292977f0d478b7efbe1
admin-user: dev (password is "kDnt4aigSY")

$ 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 | 109.98 KiB/s, done.        
Clone done, wire bytes sent: 589  received: 1663  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: a502fb1868cc5d7269d092b7f004f641b851d52c
server-id:  45f03db0607641082faad7ea40fba983b2eaad2a
admin-user: dev (password is "2KiPgtb89c")

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), 871.00 B | 10.63 KiB/s, done.        
Pull done, wire bytes sent: 441  received: 430  remote: 127.0.0.1
Committed version: bdd9521080f11e5bce1113c99653ea063d412388719fbebff8c95222b73df490
Sync with http://dev@127.0.0.1:8888
Round-trips: 1   Artifacts sent: 2  received: 0 | 100% (2/2), 1017.00 B | 13.99 KiB/s, done.        
Sync done, wire bytes sent: 715  received: 302  remote: 127.0.0.1

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

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.07 KiB | 14.68 KiB/s, done.        
Sync done, wire bytes sent: 795  received: 302  remote: 127.0.0.1

You can see client_1 changes in client_2 after sync from server

$ vb timeline
=== 2026-03-31 ===
13:00:42 [e55576ec21] *CURRENT* update (user: dev tags: dev)
13:00:42 [bdd9521080] update (user: dev tags: trunk)
13:00:41 [662f93b76e] base (user: ubuntu tags: trunk)
13:00:41 [5a94f5799f] initial empty check-in (user: ubuntu tags: trunk)
+++ no more data (4) +++

sync¶

Description¶

Options¶

Examples¶

See Also¶