The "setting" command:
fossil settings ?PROPERTY? ?VALUE? ?OPTIONS?
fossil unset PROPERTY ?OPTIONS?
The "settings" command with no arguments lists all properties and their
values. With just a property name it shows the value of that property.
With a value argument it changes the property for the current repository.
Settings marked as versionable are overridden by the contents of the
file named .fossil-settings/PROPERTY in the checked out files, if that
file exists.
The "unset" command clears a property setting.
allow-symlinks If enabled, don't follow symlinks, and instead treat
(versionable) them as symlinks on Unix. Has no effect on Windows
(existing links in repository created on Unix become
plain-text files with link destination path inside).
Default: off
auto-captcha If enabled, the Login page provides a button to
fill in the captcha password. Default: on
auto-hyperlink Use javascript to enable hyperlinks on web pages
for all users (regardless of the "h" privilege) if the
User-Agent string in the HTTP header look like it came
from real person, not a spider or bot. Default: on
auto-shun If enabled, automatically pull the shunning list
from a server to which the client autosyncs.
Default: on
autosync If enabled, automatically pull prior to commit
or update and automatically push after commit or
tag or branch creation. If the value is "pullonly"
then only pull operations occur automatically.
Default: on
binary-glob The VALUE is a comma or newline-separated list of
(versionable) GLOB patterns that should be treated as binary files
for merging purposes. Example: *.xml
case-sensitive If TRUE, the files whose names differ only in case
care considered distinct. If FALSE files whose names
differ only in case are the same file. Defaults to
TRUE for unix and FALSE for windows and mac.
clearsign When enabled, fossil will attempt to sign all commits
with gpg. When disabled (the default), commits will
be unsigned. Default: off
crnl-glob A comma or newline-separated list of GLOB patterns for
(versionable) text files in which it is ok to have CR+NL line endings.
Set to "*" to disable CR+NL checking.
default-perms Permissions given automatically to new users. For more
information on permissions see Users page in Server
Administration of the HTTP UI. Default: u.
diff-command External command to run when performing a diff.
If undefined, the internal text diff will be used.
dont-push Prevent this repository from pushing from client to
server. Useful when setting up a private branch.
empty-dirs A comma or newline-separated list of pathnames. On
(versionable) update and checkout commands, if no file or directory
exists with that name, an empty directory will be
created.
editor Text editor command used for check-in comments.
gdiff-command External command to run when performing a graphical
diff. If undefined, text diff will be used.
gmerge-command A graphical merge conflict resolver command operating
on four files.
Ex: kdiff3 "%baseline" "%original" "%merge" -o "%output"
Ex: xxdiff "%original" "%baseline" "%merge" -M "%output"
Ex: meld "%baseline" "%original" "%merge" "%output"
http-port The TCP/IP port number to use by the "server"
and "ui" commands. Default: 8080
https-login Send login creditials using HTTPS instead of HTTP
even if the login page request came via HTTP.
ignore-glob The VALUE is a comma or newline-separated list of GLOB
(versionable) patterns specifying files that the "extra" command will
ignore. Example: *.o,*.obj,*.exe
localauth If enabled, require that HTTP connections from
127.0.0.1 be authenticated by password. If
false, all HTTP requests from localhost have
unrestricted access to the repository.
main-branch The primary branch for the project. Default: trunk
manifest If enabled, automatically create files "manifest" and
(versionable) "manifest.uuid" in every checkout. The SQLite and
Fossil repositories both require this. Default: off.
max-upload A limit on the size of uplink HTTP requests. The
default is 250000 bytes.
mtime-changes Use file modification times (mtimes) to detect when
files have been modified. (Default "on".)
pgp-command Command used to clear-sign manifests at check-in.
The default is "gpg --clearsign -o ".
proxy URL of the HTTP proxy. If undefined or "off" then
the "http_proxy" environment variable is consulted.
If the http_proxy environment variable is undefined
then a direct HTTP connection is used.
relative-paths When showing changes and extras, report paths relative
to the current working directory. Default: "on"
repo-cksum Compute checksums over all files in each checkout
as a double-check of correctness. Defaults to "on".
Disable on large repositories for a performance
improvement.
self-register Allow users to register themselves through the HTTP UI.
This is useful if you want to see other names than
"Anonymous" in e.g. ticketing system. On the other hand
users can not be deleted. Default: off.
ssl-ca-location The full pathname to a file containing PEM encoded
CA root certificates, or a directory of certificates
with filenames formed from the certificate hashes as
required by OpenSSL.
If set, this will override the OS default list of
OpenSSL CAs. If unset, the default list will be used.
Some platforms may add additional certificates.
Check your platform behaviour is as required if the
exact contents of the CA root is critical for your
application.
ssl-identity The full pathname to a file containing a certificate
and private key in PEM format. Create by concatenating
the certificate and private key files.
This identity will be presented to SSL servers to
authenticate this client, in addition to the normal
password authentication.
ssh-command Command used to talk to a remote machine with
the "ssh://" protocol.
tcl If enabled, Tcl integration commands will be added to
the TH1 interpreter, allowing Tcl expressions and
scripts to be evaluated from TH1. Additionally, the
Tcl interpreter will be able to evaluate TH1 expressions
and scripts. Default: off.
web-browser A shell command used to launch your preferred
web browser when given a URL as an argument.
Defaults to "start" on windows, "open" on Mac,
and "firefox" on Unix.
Options:
--global set or unset the given property globally instead of
setting or unsetting it for the open repository only.
See also: configuration