Command-line interface

Zero Install command-lines begin with 0install.
On Windows you can also use 0install-win instead. This will display outputs using windows instead of the console.

Command	Description
select	Selects a version of the program identified by URI, and compatible versions of all of its dependencies. Returns an exit status of 0 if it selected a set of versions, and a status of 1 if it could not find a consistent set.
download	Behaves similarly to 0install select, except that it also downloads the selected versions if they are not already cached. Returns an exit status of 0 if it selected a suitable set of versions and they are now all downloaded and in the cache; returns a status of 1 otherwise.
update	Checks for updates to the program and download them if found. This is similar to 0install download --refresh, except that it prints information about whether any changes were found.
run	Behaves similarly to 0install download, except that it also runs the program after ensuring it is in the cache. Returns an exit status of 1 if the download step failed. Otherwise, the exit status will be the exit status of the program being run.
import	Imports a feed from a local file, as if it had been downloaded from the network. This is useful when testing a feed file, to avoid uploading it to a remote server in order to download it again. The file must have a trusted digital signature, as when fetching from the network.
export (Windows only)	Exports all feeds and implementations required to launch the program specified by a URI to a DIRECTORY.
search	Searches for feeds indexed by the mirror server that match specified keywords. Note that the default mirror server indexes all known feeds, regardless of quality; you must decide whether to trust the programs before running them.
list	Lists all locally known feed URIs. If a search term is given, only URIs containing that string are shown (case insensitive).
catalog search (Windows only)	Searches registered catalogs for applications that match the specified query. If no query is given all applications in the catalogs are listed.
catalog refresh (Windows only)	Refreshes (downloads) all registered catalogs.
catalog add (Windows only)	Adds an URI to the list of catalogs.
catalog remove (Windows only)	Removes an URI from the list of catalogs.
catalog reset (Windows only)	Resets the list of catalogs to the default source.
catalog list (Windows only)	Lists all registered catalogs.
config	View or change configuration settings. With no arguments, it displays all settings and their current values. With one argument, it displays the current value of the named setting. With two arguments, it sets the setting to the given value or resets it to the default value if the value default is given.
add-feed	Register an additional source of implementations (versions) of a program.
remove-feed	Un-registers a feed, reversing the effect of 0install add-feed.
list-feeds	Lists all extra feeds added to URI using 0install add-feed.
digest	Calculates the manifest digest of a directory or archive.
store add	Adds the contents of a directory or archive to the cache.
store audit	Checks that all implementations in the cache are undamaged. Additional arguments specify custom cache locations.
store copy	Copies an implementation into the cache. Similar to 0install store add, but the digest is extracted from the directory name. An additional arguments specifies a custom target cache location.
store export (Windows only)	Exports a cached implementation as an archive (ZIP, TAR, etc.). The result can be imported on another machine using 0install store add.
store find	Determines the local path of a cached implementation.
store list	Lists all implementation cache directories.
store list-implementations (Windows only)	Lists all cached implementations. If a feed URI is specified only implementations for that particular feed are listed.
store manage	Displays a graphical user interface for managing implementations in the cache. Shows associations with cached feeds.
store optimise	Saves disk space by merging identical files with hardlinks. Additional arguments specify custom cache locations.
store purge (Windows only)	Removes all implementations from the cache. Use this command to clean up the system before removing Zero Install. Deleting cache directories manually may be difficult due to the NTFS ACLs employed to protect implementations against modification. Additional arguments specify custom cache locations.
store remove	Removes an implementation from the cache.
store verify	Makes sure an implementation has not been damaged (i.e. it manifest digest has not changed).
store add-dir (Windows only)	Adds a directory to the list of custom implementation caches.
store remove-dir (Windows only)	Removes a directory from the list of custom implementation caches.
central (Windows only)	Opens the central graphical user interface for launching and managing applications.
add	Add an application to the application list.
remove (Windows only)	Removes an application from the application list and undoes any desktop environment integration.
remove-all (Windows only)	Removes all applications from the application list and undoes any desktop environment integration. Use this command to clean up the system before removing Zero Install.
destroy (Linux only)	Removes an application.
show (Linux only)	Shows the current selections for an application
whatchanged (Linux only)	Shows the differences between the current and previous selections for an application.
man (Linux only)	Shows the man-page of a given command.
integrate (Windows only)	Adds an application to the application list (if missing) and integrate it into the desktop environment.
alias (Windows only)	Create an alias for launching an application via 0install without always having to enter the full URI.
list-apps (Windows only)	Lists all applications currently in your application list. If a search term is given, only application names containing that string are shown (case insensitive).
update-all (Windows only)	Updates all applications in the application list.
repair-all (Windows only)	Reapplies all desktop integrations of applications in the application list.
sync (Windows only)	Synchronizes the application list with the server.
import-apps (Windows only)	Imports a set of applications and desktop integrations from an existing app-list.xml file.
self deploy (Windows only)	Deploys Zero Install to the specified TARGET directory or the default directory for programs and integrates it in the system.
self remove (Windows only)	Removes the current instance of Zero Install from the system.
self update (Windows only)	Updates Zero Install itself to the most recent version.

select

Selects a version of the program identified by URI, and compatible versions of all of its dependencies.
Returns an exit status of 0 if it selected a set of versions, and a status of 1 if it could not find a consistent set.

Usage: 0install select [OPTIONS] URI

Option	Description
-? -h --help	Show the built-in help text.
--background (Windows only, GUI only)	Hide the graphical user interface and use something like a tray icon instead.
--batch (Windows only)	Automatically answer questions with defaults when possible and simplify console output (no tables or progress bars).
-v --verbose	More verbose output. Use twice for even more verbose output.
--customize (Windows only)	Show the graphical policy editor. This allows you to customize which version of a program or library to use.
-o --offline	Run in off-line mode, overriding the default setting. In off-line mode, no interfaces are refreshed even if they are out-of-date, and newer versions of programs won't be downloaded even if the injector already knows about them (e.g. from a previous refresh).
-r --refresh	Fetch fresh copies of all used feeds.
--with-store DIR	Add DIR to the list of implementation caches to search. However, new downloads will not be written to this directory.
--command COMMAND	Instead of executing the default command, use COMMAND instead. Possible command names are defined in the program's interface. Set to empty ("") to ignore the command during selection.
--before VERSION	Require a version of the main program earlier than VERSION. i.e., force the use of an old version the program.
--not-before VERSION	Require a version of the main program not earlier than VERSION. E.g., if you want to run version 2.0 or later, use --not-before=2.0.
--version RANGE	Require a version of the main program within the given RANGE. Ranges are separated by pipes (|). Each range is in the form START..!END. The range matches versions where START <= VERSION < END. The start or end may be omitted. A single version number may be used instead of a range to match only that version, or !VERSION to match everything except that version.
--version-for URI RANGE	For any library or sub-component with the given URI specifies the version RANGE (as for --version).
-s --source	Select source code rather than a binary. This is used internally by 0compile.
--os OS	Forces the solver to target the operating system OS. Supported values: \*, POSIX, Linux, Solaris, FreeBSD, Darwin, MacOSX, Cygwin, Windows, unknown
--cpu CPU	Forces the solver to target a specific CPU. Supported values: \*, i386, i486, i586, i686, x86_64, ppc, ppc64, armv6l, armv7l, src
--language	Specifies the preferred language for the implementation. Use ISO short language codes (e.g. en or en-US). You can use this option multiple times to specify multiple acceptable languages.
--xml	Write selected versions to console as machine-readable XML.

download

Behaves similarly to 0install select, except that it also downloads the selected versions if they are not already cached.
Returns an exit status of 0 if it selected a suitable set of versions and they are now all downloaded and in the cache; returns a status of 1 otherwise.

Usage: 0install download [OPTIONS] URI

Option	Description
-? -h --help	Show the built-in help text.
--background (Windows only, GUI only)	Hide the graphical user interface and use something like a tray icon instead.
--batch (Windows only)	Automatically answer questions with defaults when possible and simplify console output (no tables or progress bars).
-v --verbose	More verbose output. Use twice for even more verbose output.
--customize (Windows only)	Show the graphical policy editor. This allows you to customize which version of a program or library to use.
-o --offline	Run in off-line mode, overriding the default setting. In off-line mode, no interfaces are refreshed even if they are out-of-date, and newer versions of programs won't be downloaded even if the injector already knows about them (e.g. from a previous refresh).
-r --refresh	Fetch fresh copies of all used feeds.
--with-store DIR	Add DIR to the list of implementation caches to search. However, new downloads will not be written to this directory.
--command COMMAND	Instead of executing the default command, use COMMAND instead. Possible command names are defined in the program's interface. Set to empty ("") to ignore the command during selection.
--before VERSION	Require a version of the main program earlier than VERSION. i.e., force the use of an old version the program.
--not-before VERSION	Require a version of the main program not earlier than VERSION. E.g., if you want to run version 2.0 or later, use --not-before=2.0.
--version RANGE	Require a version of the main program within the given RANGE. Ranges are separated by pipes (|). Each range is in the form START..!END. The range matches versions where START <= VERSION < END. The start or end may be omitted. A single version number may be used instead of a range to match only that version, or !VERSION to match everything except that version.
--version-for URI RANGE	For any library or sub-component with the given URI specifies the version RANGE (as for --version).
-s --source	Select source code rather than a binary. This is used internally by 0compile.
--os OS	Forces the solver to target the operating system OS. Supported values: \*, POSIX, Linux, Solaris, FreeBSD, Darwin, MacOSX, Cygwin, Windows, unknown
--cpu CPU	Forces the solver to target a specific CPU. Supported values: \*, i386, i486, i586, i686, x86_64, ppc, ppc64, armv6l, armv7l, src
--language	Specifies the preferred language for the implementation. Use ISO short language codes (e.g. en or en-US). You can use this option multiple times to specify multiple acceptable languages.
--xml	Write selected versions to console as machine-readable XML.
--show	Show where the selected components are stored on the disk.

update

Checks for updates to the program and download them if found.
This is similar to 0install download --refresh, except that it prints information about whether any changes were found.

Usage: 0install update [OPTIONS] URI

Option	Description
-? -h --help	Show the built-in help text.
--background (Windows only, GUI only)	Hide the graphical user interface and use something like a tray icon instead.
--batch (Windows only)	Automatically answer questions with defaults when possible and simplify console output (no tables or progress bars).
-v --verbose	More verbose output. Use twice for even more verbose output.
--customize (Windows only)	Show the graphical policy editor. This allows you to customize which version of a program or library to use.
--with-store DIR	Add DIR to the list of implementation caches to search. However, new downloads will not be written to this directory.
--command COMMAND	Instead of executing the default command, use COMMAND instead. Possible command names are defined in the program's interface. Set to empty ("") to ignore the command during selection.
--before VERSION	Require a version of the main program earlier than VERSION. i.e., force the use of an old version the program.
--not-before VERSION	Require a version of the main program not earlier than VERSION. E.g., if you want to run version 2.0 or later, use --not-before=2.0.
--version RANGE	Require a version of the main program within the given RANGE. Ranges are separated by pipes (|). Each range is in the form START..!END. The range matches versions where START <= VERSION < END. The start or end may be omitted. A single version number may be used instead of a range to match only that version, or !VERSION to match everything except that version.
--version-for URI RANGE	For any library or sub-component with the given URI specifies the version RANGE (as for --version).
-s --source	Select source code rather than a binary. This is used internally by 0compile.
--os OS	Forces the solver to target the operating system OS. Supported values: \*, POSIX, Linux, Solaris, FreeBSD, Darwin, MacOSX, Cygwin, Windows, unknown
--cpu CPU	Forces the solver to target a specific CPU. Supported values: \*, i386, i486, i586, i686, x86_64, ppc, ppc64, armv6l, armv7l, src
--language	Specifies the preferred language for the implementation. Use ISO short language codes (e.g. en or en-US). You can use this option multiple times to specify multiple acceptable languages.

run

Behaves similarly to 0install download, except that it also runs the program after ensuring it is in the cache.
Returns an exit status of 1 if the download step failed. Otherwise, the exit status will be the exit status of the program being run.

Usage: 0install run [OPTIONS] URI [ARGS]

Option	Description
-? -h --help	Show the built-in help text.
--background (Windows only, GUI only)	Hide the graphical user interface and use something like a tray icon instead.
--batch (Windows only)	Automatically answer questions with defaults when possible and simplify console output (no tables or progress bars).
-v --verbose	More verbose output. Use twice for even more verbose output.
--customize (Windows only)	Show the graphical policy editor. This allows you to customize which version of a program or library to use.
-o --offline	Run in off-line mode, overriding the default setting. In off-line mode, no interfaces are refreshed even if they are out-of-date, and newer versions of programs won't be downloaded even if the injector already knows about them (e.g. from a previous refresh).
-r --refresh	Fetch fresh copies of all used feeds.
--with-store DIR	Add DIR to the list of implementation caches to search. However, new downloads will not be written to this directory.
--command COMMAND	Instead of executing the default command, use COMMAND instead. Possible command names are defined in the program's interface. Set to empty ("") to ignore the command during selection.
--before VERSION	Require a version of the main program earlier than VERSION. i.e., force the use of an old version the program.
--not-before VERSION	Require a version of the main program not earlier than VERSION. E.g., if you want to run version 2.0 or later, use --not-before=2.0.
--version RANGE	Require a version of the main program within the given RANGE. Ranges are separated by pipes (|). Each range is in the form START..!END. The range matches versions where START <= VERSION < END. The start or end may be omitted. A single version number may be used instead of a range to match only that version, or !VERSION to match everything except that version.
--version-for URI RANGE	For any library or sub-component with the given URI specifies the version RANGE (as for --version).
-s --source	Select source code rather than a binary. This is used internally by 0compile.
--os OS	Forces the solver to target the operating system OS. Supported values: \*, POSIX, Linux, Solaris, FreeBSD, Darwin, MacOSX, Cygwin, Windows, unknown
--cpu CPU	Forces the solver to target a specific CPU. Supported values: \*, i386, i486, i586, i686, x86_64, ppc, ppc64, armv6l, armv7l, src
--language	Specifies the preferred language for the implementation. Use ISO short language codes (e.g. en or en-US). You can use this option multiple times to specify multiple acceptable languages.
-m MAIN --main MAIN	Run the specified executable MAIN instead of the default. If it starts with / or \ then the path is relative to the implementation's top-level directory, whereas otherwise it is relative to the directory containing the default main program. May not contain command-line arguments! Whitespaces do not need to be escaped.
-w COMMAND --wrapper COMMAND	Instead of executing the chosen program directly, run COMMAND PROGRAM ARGS. This is useful for running debuggers and tracing tools on the program (rather than on Zero Install!). Note that the wrapper is executed in the environment selected by the program; hence, this mechanism cannot be used for sandboxing. May contain command-line arguments. Whitespaces must be escaped!
--no-wait (Windows only)	Immediately returns once the chosen program has been launched instead of waiting for it to finish executing. On Windows the exit code is the process ID of the launched program.

import

Imports a feed from a local file, as if it had been downloaded from the network. This is useful when testing a feed file, to avoid uploading it to a remote server in order to download it again.
The file must have a trusted digital signature, as when fetching from the network.

Usage: 0install import FEED-FILE [...]

Option	Description
-? -h --help	Show the built-in help text.
--background (Windows only, GUI only)	Hide the graphical user interface and use something like a tray icon instead.
--batch (Windows only)	Automatically answer questions with defaults when possible and simplify console output (no tables or progress bars).
-v --verbose	More verbose output. Use twice for even more verbose output.

export

Exports all feeds and implementations required to launch the program specified by a URI to a DIRECTORY.

Usage: 0install export [OPTIONS] URI DIRECTORY

Option	Description
-? -h --help	Show the built-in help text.
--background (Windows only, GUI only)	Hide the graphical user interface and use something like a tray icon instead.
--batch (Windows only)	Automatically answer questions with defaults when possible and simplify console output (no tables or progress bars).
-v --verbose	More verbose output. Use twice for even more verbose output.
--customize (Windows only)	Show the graphical policy editor. This allows you to customize which version of a program or library to use.
-o --offline	Run in off-line mode, overriding the default setting. In off-line mode, no interfaces are refreshed even if they are out-of-date, and newer versions of programs won't be downloaded even if the injector already knows about them (e.g. from a previous refresh).
-r --refresh	Fetch fresh copies of all used feeds.
--with-store DIR	Add DIR to the list of implementation caches to search. However, new downloads will not be written to this directory.
--command COMMAND	Instead of executing the default command, use COMMAND instead. Possible command names are defined in the program's interface. Set to empty ("") to ignore the command during selection.
--before VERSION	Require a version of the main program earlier than VERSION. i.e., force the use of an old version the program.
--not-before VERSION	Require a version of the main program not earlier than VERSION. E.g., if you want to run version 2.0 or later, use --not-before=2.0.
--version RANGE	Require a version of the main program within the given RANGE. Ranges are separated by pipes (|). Each range is in the form START..!END. The range matches versions where START <= VERSION < END. The start or end may be omitted. A single version number may be used instead of a range to match only that version, or !VERSION to match everything except that version.
--version-for URI RANGE	For any library or sub-component with the given URI specifies the version RANGE (as for --version).
-s --source	Select source code rather than a binary. This is used internally by 0compile.
--os OS	Forces the solver to target the operating system OS. Supported values: \*, POSIX, Linux, Solaris, FreeBSD, Darwin, MacOSX, Cygwin, Windows, unknown
--cpu CPU	Forces the solver to target a specific CPU. Supported values: \*, i386, i486, i586, i686, x86_64, ppc, ppc64, armv6l, armv7l, src
--language	Specifies the preferred language for the implementation. Use ISO short language codes (e.g. en or en-US). You can use this option multiple times to specify multiple acceptable languages.
--no-implementations	Do not include implementation archives in the export. Only export feeds.
--include-zero-install	Include Zero Install itself in the export alongside the application.
--bootstrap VALUE	Choose the type of Bootstrapper to place alongside the export. Supported values: None, Run, Integrate

search

Searches for feeds indexed by the mirror server that match specified keywords. Note that the default mirror server indexes all known feeds, regardless of quality; you must decide whether to the programs before running them.

Usage: 0install search QUERY

Option	Description
-? -h --help	Show the built-in help text.
--background (Windows only, GUI only)	Hide the graphical user interface and use something like a tray icon instead.
--batch (Windows only)	Automatically answer questions with defaults when possible and simplify console output (no tables or progress bars).
-v --verbose	More verbose output. Use twice for even more verbose output.

list

Lists all locally known feed URIs. If a search term is given, only URIs containing that string are shown (case insensitive).

Usage: 0install list [PATTERN]

Option	Description
-? -h --help	Show the built-in help text.
--background (Windows only, GUI only)	Hide the graphical user interface and use something like a tray icon instead.
--batch (Windows only)	Automatically answer questions with defaults when possible and simplify console output (no tables or progress bars).
-v --verbose	More verbose output. Use twice for even more verbose output.

catalog search

Searches registered catalogs for applications that match the specified query. If no query is given all applications in the catalogs are listed.

Usage: 0install catalog search [QUERY]

Option	Description
-? -h --help	Show the built-in help text.
--background (Windows only, GUI only)	Hide the graphical user interface and use something like a tray icon instead.
--batch (Windows only)	Automatically answer questions with defaults when possible and simplify console output (no tables or progress bars).
-v --verbose	More verbose output. Use twice for even more verbose output.

catalog refresh

Refreshes (downloads) all registered catalogs.

Usage: 0install catalog refresh

Option	Description
-? -h --help	Show the built-in help text.
--background (Windows only, GUI only)	Hide the graphical user interface and use something like a tray icon instead.
--batch (Windows only)	Automatically answer questions with defaults when possible and simplify console output (no tables or progress bars).
-v --verbose	More verbose output. Use twice for even more verbose output.

catalog add

Adds an URI to the list of catalogs.

Usage: 0install catalog add URI

Option	Description
-? -h --help	Show the built-in help text.
--background (Windows only, GUI only)	Hide the graphical user interface and use something like a tray icon instead.
--batch (Windows only)	Automatically answer questions with defaults when possible and simplify console output (no tables or progress bars).
-v --verbose	More verbose output. Use twice for even more verbose output.
--skip-verify	Skip downloading the catalog to verify it is valid before adding it to the list.

catalog remove

Removes an URI from the list of catalogs.

Usage: 0install catalog remove URI

Option	Description
-? -h --help	Show the built-in help text.
--background (Windows only, GUI only)	Hide the graphical user interface and use something like a tray icon instead.
--batch (Windows only)	Automatically answer questions with defaults when possible and simplify console output (no tables or progress bars).
-v --verbose	More verbose output. Use twice for even more verbose output.

catalog reset

Resets the list of catalogs to the default source.

Usage: 0install catalog reset

Option	Description
-? -h --help	Show the built-in help text.
--background (Windows only, GUI only)	Hide the graphical user interface and use something like a tray icon instead.
--batch (Windows only)	Automatically answer questions with defaults when possible and simplify console output (no tables or progress bars).
-v --verbose	More verbose output. Use twice for even more verbose output.

catalog list

Lists all registered catalogs.

Usage: 0install catalog list

Option	Description
-? -h --help	Show the built-in help text.
--background (Windows only, GUI only)	Hide the graphical user interface and use something like a tray icon instead.
--batch (Windows only)	Automatically answer questions with defaults when possible and simplify console output (no tables or progress bars).
-v --verbose	More verbose output. Use twice for even more verbose output.

config

View or change configuration settings.
With no arguments, it displays all settings and their current values. With one argument, it displays the current value of the named setting. With two arguments, it sets the setting to the given value or resets it to the default value if the value default is given.

Usage: 0install config [NAME [VALUE|default]]

Option	Description
-? -h --help	Show the built-in help text.
--background (Windows only, GUI only)	Hide the graphical user interface and use something like a tray icon instead.
--batch (Windows only)	Automatically answer questions with defaults when possible and simplify console output (no tables or progress bars).
-v --verbose	More verbose output. Use twice for even more verbose output.
--tab TAB	Switch to a specific tab in the configuration GUI. Possible TABs are updates, storage, catalog, trust, sync, language, language and advanced. Has no effect in text-mode.

add-feed

Register an additional source of implementations (versions) of a program.

Usage: 0install add-feed [OPTIONS] [INTERFACE] FEED

Option	Description
-? -h --help	Show the built-in help text.
--background (Windows only, GUI only)	Hide the graphical user interface and use something like a tray icon instead.
--batch (Windows only)	Automatically answer questions with defaults when possible and simplify console output (no tables or progress bars).
-v --verbose	More verbose output. Use twice for even more verbose output.
-o --offline	Run in off-line mode, overriding the default setting. In off-line mode, no interfaces are refreshed even if they are out-of-date, and newer versions of programs won't be downloaded even if the injector already knows about them (e.g. from a previous refresh).
-r --refresh	Fetch fresh copies of all used feeds.

remove-feed

Un-registers a feed, reversing the effect of 0install add-feed.

Usage: 0install remove-feed [OPTIONS] [INTERFACE] FEED

Option	Description
-? -h --help	Show the built-in help text.
--background (Windows only, GUI only)	Hide the graphical user interface and use something like a tray icon instead.
--batch (Windows only)	Automatically answer questions with defaults when possible and simplify console output (no tables or progress bars).
-v --verbose	More verbose output. Use twice for even more verbose output.
-o --offline	Run in off-line mode, overriding the default setting. In off-line mode, no interfaces are refreshed even if they are out-of-date, and newer versions of programs won't be downloaded even if the injector already knows about them (e.g. from a previous refresh).
-r --refresh	Fetch fresh copies of all used feeds.

list-feeds

Lists all extra feeds added to URI using 0install add-feed.

Usage: 0install list-feeds [OPTIONS] URI

Option	Description
-? -h --help	Show the built-in help text.
--background (Windows only, GUI only)	Hide the graphical user interface and use something like a tray icon instead.
--batch (Windows only)	Automatically answer questions with defaults when possible and simplify console output (no tables or progress bars).
-v --verbose	More verbose output. Use twice for even more verbose output.

digest

Calculates the manifest digest of a directory or archive.

Usage: 0install digest (DIRECTORY | ARCHIVE [SUBDIR])

Option	Description
-? -h --help	Show the built-in help text.
--background (Windows only, GUI only)	Hide the graphical user interface and use something like a tray icon instead.
--batch (Windows only)	Automatically answer questions with defaults when possible and simplify console output (no tables or progress bars).
-v --verbose	More verbose output. Use twice for even more verbose output.
--manifest	Display the manifest itself (one line for each file or directory).
--digest	Display the manifest's digest (enabled by default if --manifest is not set).
--algorithm HASH	The HASH algorithm to use for the digest. Supported values: sha256new, sha256, sha1new

store add

Adds the contents of a directory or archive to the cache.

Usage: 0install store add DIGEST (DIRECTORY | (ARCHIVE [EXTRACT [MIME-TYPE [...]]))

Option	Description
-? -h --help	Show the built-in help text.
--background (Windows only, GUI only)	Hide the graphical user interface and use something like a tray icon instead.
--batch (Windows only)	Automatically answer questions with defaults when possible and simplify console output (no tables or progress bars).
-v --verbose	More verbose output. Use twice for even more verbose output.

store audit

Checks that all implementations in the cache are undamaged.
Additional arguments specify custom cache locations.

Usage: 0install store audit [CACHE-DIR+]

Option	Description
-? -h --help	Show the built-in help text.
--background (Windows only, GUI only)	Hide the graphical user interface and use something like a tray icon instead.
--batch (Windows only)	Automatically answer questions with defaults when possible and simplify console output (no tables or progress bars).
-v --verbose	More verbose output. Use twice for even more verbose output.

store copy

Copies an implementation into the cache. Similar to 0install store add, but the digest is extracted from the directory name.
An additional arguments specifies a custom target cache location.

Usage: 0install store copy DIRECTORY [CACHE]

Option	Description
-? -h --help	Show the built-in help text.
--background (Windows only, GUI only)	Hide the graphical user interface and use something like a tray icon instead.
--batch (Windows only)	Automatically answer questions with defaults when possible and simplify console output (no tables or progress bars).
-v --verbose	More verbose output. Use twice for even more verbose output.

store export

Exports a cached implementation as an archive (ZIP, TAR, etc.). The result can be imported on another machine using 0install store add.

Usage: 0install store export DIGEST OUTPUT-ARCHIVE [MIME-TYPE]

Option	Description
-? -h --help	Show the built-in help text.
--background (Windows only, GUI only)	Hide the graphical user interface and use something like a tray icon instead.
--batch (Windows only)	Automatically answer questions with defaults when possible and simplify console output (no tables or progress bars).
-v --verbose	More verbose output. Use twice for even more verbose output.

store find

Determines the local path of a cached implementation.

Usage: 0install store find DIGEST

Option	Description
-? -h --help	Show the built-in help text.
--background (Windows only, GUI only)	Hide the graphical user interface and use something like a tray icon instead.
--batch (Windows only)	Automatically answer questions with defaults when possible and simplify console output (no tables or progress bars).
-v --verbose	More verbose output. Use twice for even more verbose output.

store list

Lists all implementation cache directories.

Usage: 0install store list

Option	Description
-? -h --help	Show the built-in help text.
--background (Windows only, GUI only)	Hide the graphical user interface and use something like a tray icon instead.
--batch (Windows only)	Automatically answer questions with defaults when possible and simplify console output (no tables or progress bars).
-v --verbose	More verbose output. Use twice for even more verbose output.

store list-implementations

Lists all cached implementations. If a feed URI is specified only implementations for that particular feed are listed.

Usage: 0install store list-implementations [FEED-URI]

Option	Description
-? -h --help	Show the built-in help text.
--background (Windows only, GUI only)	Hide the graphical user interface and use something like a tray icon instead.
--batch (Windows only)	Automatically answer questions with defaults when possible and simplify console output (no tables or progress bars).
-v --verbose	More verbose output. Use twice for even more verbose output.

store manage

Displays a graphical user interface for managing implementations in the cache. Shows associations with cached feeds.

Usage: 0install store manage

Option	Description
-? -h --help	Show the built-in help text.
--background (Windows only, GUI only)	Hide the graphical user interface and use something like a tray icon instead.
--batch (Windows only)	Automatically answer questions with defaults when possible and simplify console output (no tables or progress bars).
-v --verbose	More verbose output. Use twice for even more verbose output.

store optimise

Saves disk space by merging identical files with hardlinks.
Additional arguments specify custom cache locations.

Usage: 0install store optimise [CACHE-DIR+]

Option	Description
-? -h --help	Show the built-in help text.
--background (Windows only, GUI only)	Hide the graphical user interface and use something like a tray icon instead.
--batch (Windows only)	Automatically answer questions with defaults when possible and simplify console output (no tables or progress bars).
-v --verbose	More verbose output. Use twice for even more verbose output.

store purge

Removes all implementations from the cache. Use this command to clean up the system before removing Zero Install. Deleting cache directories manually may be difficult due to the NTFS ACLs yed to protect implementations against modification.
Additional arguments specify custom cache locations.

Usage: 0install store purge [CACHE-DIR+]

Option	Description
-? -h --help	Show the built-in help text.
--background (Windows only, GUI only)	Hide the graphical user interface and use something like a tray icon instead.
--batch (Windows only)	Automatically answer questions with defaults when possible and simplify console output (no tables or progress bars).
-v --verbose	More verbose output. Use twice for even more verbose output.

store remove

Removes an implementation from the cache.

Usage: 0install store remove DIGEST+

Option	Description
-? -h --help	Show the built-in help text.
--background (Windows only, GUI only)	Hide the graphical user interface and use something like a tray icon instead.
--batch (Windows only)	Automatically answer questions with defaults when possible and simplify console output (no tables or progress bars).
-v --verbose	More verbose output. Use twice for even more verbose output.

store verify

Makes sure an implementation has not been damaged (i.e. if manifest digest has not changed).

Usage: 0install store verify [DIRECTORY] DIGEST

Option	Description
-? -h --help	Show the built-in help text.
--background (Windows only, GUI only)	Hide the graphical user interface and use something like a tray icon instead.
--batch (Windows only)	Automatically answer questions with defaults when possible and simplify console output (no tables or progress bars).
-v --verbose	More verbose output. Use twice for even more verbose output.

store add-dir

Adds a directory to the list of custom implementation caches.

Usage: 0install store add-dir PATH

Option	Description
-? -h --help	Show the built-in help text.
--background (Windows only, GUI only)	Hide the graphical user interface and use something like a tray icon instead.
--batch (Windows only)	Automatically answer questions with defaults when possible and simplify console output (no tables or progress bars).
-v --verbose	More verbose output. Use twice for even more verbose output.
-m --machine (Windows only)	Apply the configuration machine-wide (for the entire computer) instead of just for the current user.

store remove-dir

Removes a directory from the list of custom implementation caches.

Usage: 0install store remove-dir PATH

Option	Description
-? -h --help	Show the built-in help text.
--background (Windows only, GUI only)	Hide the graphical user interface and use something like a tray icon instead.
--batch (Windows only)	Automatically answer questions with defaults when possible and simplify console output (no tables or progress bars).
-v --verbose	More verbose output. Use twice for even more verbose output.
-m --machine (Windows only)	Apply the configuration machine-wide (for the entire computer) instead of just for the current user.

central

Opens the central graphical user interface for launching and managing applications.

Usage: 0install central [OPTIONS]

Option	Description
-? -h --help	Show the built-in help text.
--background (Windows only, GUI only)	Hide the graphical user interface and use something like a tray icon instead.
--batch (Windows only)	Automatically answer questions with defaults when possible and simplify console output (no tables or progress bars).
-v --verbose	More verbose output. Use twice for even more verbose output.
-m --machine (Windows only)	Apply the configuration machine-wide (for the entire computer) instead of just for the current user.

add

Add an application to the application list.

Usage Linux: 0install add [OPTIONS] NAME URI
Usage Windows: 0install add [OPTIONS] [NAME] URI

Option	Description
-? -h --help	Show the built-in help text.
--background (Windows only, GUI only)	Hide the graphical user interface and use something like a tray icon instead.
--batch (Windows only)	Automatically answer questions with defaults when possible and simplify console output (no tables or progress bars).
-v --verbose	More verbose output. Use twice for even more verbose output.
-o --offline	Run in off-line mode, overriding the default setting. In off-line mode, no interfaces are refreshed even if they are out-of-date, and newer versions of programs won't be downloaded even if the injector already knows about them (e.g. from a previous refresh).
-r --refresh	Fetch fresh copies of all used feeds.
-m --machine (Windows only)	Apply the configuration machine-wide (for the entire computer) instead of just for the current user.
--no-download (Windows only)	Do not download the application itself yet. Will be automatically downloaded on first use instead.

remove

Removes an application from the application list and undoes any desktop environment integration.

Usage: 0install remove [OPTIONS] (ALIAS|INTERFACE)

Option	Description
-? -h --help	Show the built-in help text.
--background (Windows only, GUI only)	Hide the graphical user interface and use something like a tray icon instead.
--batch (Windows only)	Automatically answer questions with defaults when possible and simplify console output (no tables or progress bars).
-v --verbose	More verbose output. Use twice for even more verbose output.
-o --offline	Run in off-line mode, overriding the default setting. In off-line mode, no interfaces are refreshed even if they are out-of-date, and newer versions of programs won't be downloaded even if the injector already knows about them (e.g. from a previous refresh).
-r --refresh	Fetch fresh copies of all used feeds.
-m --machine (Windows only)	Apply the configuration machine-wide (for the entire computer) instead of just for the current user.

remove-all

Removes all applications from the application list and undoes any desktop environment integration. Use this command to clean up the system before removing Zero Install.

Usage: 0install remove-all [OPTIONS]

Option	Description
-? -h --help	Show the built-in help text.
--background (Windows only, GUI only)	Hide the graphical user interface and use something like a tray icon instead.
--batch (Windows only)	Automatically answer questions with defaults when possible and simplify console output (no tables or progress bars).
-v --verbose	More verbose output. Use twice for even more verbose output.
-o --offline	Run in off-line mode, overriding the default setting. In off-line mode, no interfaces are refreshed even if they are out-of-date, and newer versions of programs won't be downloaded even if the injector already knows about them (e.g. from a previous refresh).
-r --refresh	Fetch fresh copies of all used feeds.
-m --machine (Windows only)	Apply the configuration machine-wide (for the entire computer) instead of just for the current user.

integrate

Adds an application to the application list (if missing) and integrate it into the desktop environment.

Usage: 0install integrate [OPTIONS] (ALIAS|INTERFACE)

Option	Description
-? -h --help	Show the built-in help text.
--background (Windows only, GUI only)	Hide the graphical user interface and use something like a tray icon instead.
--batch (Windows only)	Automatically answer questions with defaults when possible and simplify console output (no tables or progress bars).
-v --verbose	More verbose output. Use twice for even more verbose output.
-o --offline	Run in off-line mode, overriding the default setting. In off-line mode, no interfaces are refreshed even if they are out-of-date, and newer versions of programs won't be downloaded even if the injector already knows about them (e.g. from a previous refresh).
-r --refresh	Fetch fresh copies of all used feeds.
-m --machine (Windows only)	Apply the configuration machine-wide (for the entire computer) instead of just for the current user.
--no-download (Windows only)	Do not download the application itself yet. Will be automatically downloaded on first use instead.
--add-standard	Add the recommended standard access points.
--add-all	Add all available access points.
--add CATEGORY	Add all access points of a specific CATEGORY. Supported values: capabilities, menu, desktop, send-to, aliases, auto-start, default-app
--remove-all	Remove all access points.
--remove CATEGORY	Remove all access points of a specific CATEGORY. Supported values: capabilities, menu, desktop, send-to, aliases, auto-start, default-app

alias

Create an alias for launching an application via 0install without always having to enter the full URI.

Usage: 0install alias ALIAS [INTERFACE [COMMAND]]

Option	Description
-? -h --help	Show the built-in help text.
--background (Windows only, GUI only)	Hide the graphical user interface and use something like a tray icon instead.
--batch (Windows only)	Automatically answer questions with defaults when possible and simplify console output (no tables or progress bars).
-v --verbose	More verbose output. Use twice for even more verbose output.
-o --offline	Run in off-line mode, overriding the default setting. In off-line mode, no interfaces are refreshed even if they are out-of-date, and newer versions of programs won't be downloaded even if the injector already knows about them (e.g. from a previous refresh).
-r --refresh	Fetch fresh copies of all used feeds.
-m --machine (Windows only)	Apply the configuration machine-wide (for the entire computer) instead of just for the current user.
--no-download (Windows only)	Do not download the application itself yet. Will be automatically downloaded on first use instead.
--resolve	Print the interface URI for the given alias.
--remove	Remove an existing alias.

list-apps

Lists all applications currently in your application list. If a search term is given, only application names containing that string are shown (case insensitive).

Usage: 0install list-apps [PATTERN]

Option	Description
-? -h --help	Show the built-in help text.
--background (Windows only, GUI only)	Hide the graphical user interface and use something like a tray icon instead.
--batch (Windows only)	Automatically answer questions with defaults when possible and simplify console output (no tables or progress bars).
-v --verbose	More verbose output. Use twice for even more verbose output.
-o --offline	Run in off-line mode, overriding the default setting. In off-line mode, no interfaces are refreshed even if they are out-of-date, and newer versions of programs won't be downloaded even if the injector already knows about them (e.g. from a previous refresh).
-r --refresh	Fetch fresh copies of all used feeds.
-m --machine (Windows only)	Apply the configuration machine-wide (for the entire computer) instead of just for the current user.

update-all

Updates all applications in the application list.

Usage: 0install update-all [OPTIONS]

Option	Description
-? -h --help	Show the built-in help text.
--background (Windows only, GUI only)	Hide the graphical user interface and use something like a tray icon instead.
--batch (Windows only)	Automatically answer questions with defaults when possible and simplify console output (no tables or progress bars).
-v --verbose	More verbose output. Use twice for even more verbose output.
-o --offline	Run in off-line mode, overriding the default setting. In off-line mode, no interfaces are refreshed even if they are out-of-date, and newer versions of programs won't be downloaded even if the injector already knows about them (e.g. from a previous refresh).
-r --refresh	Fetch fresh copies of all used feeds.
-m --machine (Windows only)	Apply the configuration machine-wide (for the entire computer) instead of just for the current user.
-c --clean	Remove implementations no longer required after the update.

repair-all

Reapplies all desktop integrations of applications in the application list.

Usage: 0install repair-all [OPTIONS]

Option	Description
-? -h --help	Show the built-in help text.
--background (Windows only, GUI only)	Hide the graphical user interface and use something like a tray icon instead.
--batch (Windows only)	Automatically answer questions with defaults when possible and simplify console output (no tables or progress bars).
-v --verbose	More verbose output. Use twice for even more verbose output.
-o --offline	Run in off-line mode, overriding the default setting. In off-line mode, no interfaces are refreshed even if they are out-of-date, and newer versions of programs won't be downloaded even if the injector already knows about them (e.g. from a previous refresh).
-r --refresh	Fetch fresh copies of all used feeds.
-m --machine (Windows only)	Apply the configuration machine-wide (for the entire computer) instead of just for the current user.

sync

Synchronizes the application list with the server.

Usage: 0install sync [OPTIONS]

Option	Description
-? -h --help	Show the built-in help text.
--background (Windows only, GUI only)	Hide the graphical user interface and use something like a tray icon instead.
--batch (Windows only)	Automatically answer questions with defaults when possible and simplify console output (no tables or progress bars).
-v --verbose	More verbose output. Use twice for even more verbose output.
-o --offline	Run in off-line mode, overriding the default setting. In off-line mode, no interfaces are refreshed even if they are out-of-date, and newer versions of programs won't be downloaded even if the injector already knows about them (e.g. from a previous refresh).
-r --refresh	Fetch fresh copies of all used feeds.
-m --machine (Windows only)	Apply the configuration machine-wide (for the entire computer) instead of just for the current user.
--reset MODE	Reset the synchronization data. Supported values: none (merge data from client and server normally), client (replace all data on client with data from server) and server (replace all data on server with data from client).

import-apps

Imports a set of applications and desktop integrations from an existing app-list.xml file.

Usage: 0install import-apps APP-LIST-FILE [OPTIONS]

Option	Description
-? -h --help	Show the built-in help text.
--background (Windows only, GUI only)	Hide the graphical user interface and use something like a tray icon instead.
--batch (Windows only)	Automatically answer questions with defaults when possible and simplify console output (no tables or progress bars).
-v --verbose	More verbose output. Use twice for even more verbose output.
-o --offline	Run in off-line mode, overriding the default setting. In off-line mode, no interfaces are refreshed even if they are out-of-date, and newer versions of programs won't be downloaded even if the injector already knows about them (e.g. from a previous refresh).
-r --refresh	Fetch fresh copies of all used feeds.
-m --machine (Windows only)	Apply the configuration machine-wide (for the entire computer) instead of just for the current user.
--no-download (Windows only)	Do not download the application itself yet. Will be automatically downloaded on first use instead.

self deploy

Deploys Zero Install to the specified TARGET directory or the default directory for programs and integrates it in the system.

Usage: 0install self deploy [TARGET]

Option	Description
-? -h --help	Show the built-in help text.
--background (Windows only, GUI only)	Hide the graphical user interface and use something like a tray icon instead.
--batch (Windows only)	Automatically answer questions with defaults when possible and simplify console output (no tables or progress bars).
-v --verbose	More verbose output. Use twice for even more verbose output.
-m --machine (Windows only)	Apply the configuration machine-wide (for the entire computer) instead of just for the current user.
-p --portable	Create a portable installation that can be moved around (e.g., on a thumb drive).
--restart-central	Restart the 0install central GUI after the update.

self remove

Removes the current instance of Zero Install from the system.

Usage: 0install self remove

Option	Description
-? -h --help	Show the built-in help text.
--background (Windows only, GUI only)	Hide the graphical user interface and use something like a tray icon instead.
--batch (Windows only)	Automatically answer questions with defaults when possible and simplify console output (no tables or progress bars).
-v --verbose	More verbose output. Use twice for even more verbose output.

self update

Updates Zero Install itself to the most recent version.

Usage: 0install self update [OPTIONS]

Option	Description
-? -h --help	Show the built-in help text.
--background (Windows only, GUI only)	Hide the graphical user interface and use something like a tray icon instead.
--batch (Windows only)	Automatically answer questions with defaults when possible and simplify console output (no tables or progress bars).
-v --verbose	More verbose output. Use twice for even more verbose output.
--with-store DIR	Add DIR to the list of implementation caches to search. However, new downloads will not be written to this directory.
--before VERSION	Require a version of the main program earlier than VERSION. i.e., force the use of an old version the program.
--not-before VERSION	Require a version of the main program not earlier than VERSION. E.g., if you want to run version 2.0 or later, use --not-before=2.0.
--version RANGE	Require a version of the main program within the given RANGE. Ranges are separated by pipes (|). Each range is in the form START..!END. The range matches versions where START <= VERSION < END. The start or end may be omitted. A single version number may be used instead of a range to match only that version, or !VERSION to match everything except that version.
--version-for URI RANGE	For any library or sub-component with the given URI specifies the version RANGE (as for --version).
--language	Specifies the preferred language for the implementation. Use ISO short language codes (e.g. en or en-US). You can use this option multiple times to specify multiple acceptable languages.
--force	Perform the update even if the currently installed version is the same or newer.
--restart-central	Restart the 0install central GUI after the update.