View or modify the URLs of remote repositories used for syncing. The "default" remote is the URL used in the most recent "sync", "push", "pull", "clone", or similar command. The default remote can change with each sync command. Other named remotes are persistent.

fossil remote

With no arguments, this command shows the current default remote URL. If there is no default, it shows "off".

fossil remote add NAME URL

Add a new named URL. Afterwards, NAME can be used as a short symbolic name for URL in contexts where a URL is required. The URL argument can be "default" or a prior symbolic name, to make a copy of an existing URL under a new name.

fossil remote config-data

DEBUG USE ONLY - Show the name and value of every CONFIG table entry in the repository that is associated with the remote URL store. Passwords are obscured in the output.

fossil remote delete NAME

Delete a named URL previously created by the "add" subcommand.

fossil remote list|ls

Show all remote repository URLs.

fossil remote off

Forget the default URL. This disables autosync.

This is a convenient way to enter "airplane mode". To enter airplane mode, first save the current default URL, then turn the default off. Perhaps like this:

fossil remote add main default
fossil remote off

To exit airplane mode and turn autosync back on again:

fossil remote main

fossil remote scrub

Forget any saved passwords for remote repositories, but continue to remember the URLs themselves. You will be prompted for the password the next time it is needed.

fossil remote REF

Make REF the new default URL, replacing the prior default. REF may be a URL or a NAME from a prior "add".