Command-line

Zero Install command-lines usually begin with 0install. If you use 0install-win instead outputs are displayed using windows instead of the console. Scripts can use a number of Exit Codes to detect failure conditions.

Command Description
central Opens the central graphical user interface for launching and managing applications.
self-update 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 zero 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 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 Searches registered catalogs for applications that match the specified query. If no query is given all applications in the catalogs are listed.
catalog refresh Refreshes (downloads) all registered catalogs.
catalog add Adds an URI to the list of catalogs.
catalog remove Removes an URI from the list of catalogs.
catalog reset Resets the list of catalogs to the default source.
catalog list 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'.
add Add an application to the application list.
remove Removes an application from the application list and undoes any desktop environment integration.
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.
integrate Adds an application to the application list (if missing) and integrate it into the desktop environment.
alias Create an alias for launching an application via 0install without always having to enter the full URI.
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).
update-all Updates all applications in the application list.
repair-all Reapplies all desktop integrations of applications in the application list.
sync Synchronizes the application list with the server.
import-apps Imports a set of applications and desktop integrations from an existing app-list.xml file.
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 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 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 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 Adds a directory to the list of custom implementation caches.
store remove-dir Removes a directory from the list of custom implementation caches.
maintenance deploy Deploys Zero Install to the specified TARGET directory or the default directory for programs and integrates it in the system.
maintenance remove Removes the current instance of Zero Install from the system.

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 Hide the graphical user interface and use something like a tray icon instead. Has no effect in command-line mode.
--batch Automatically answer questions with defaults when possible. Avoid unnecessary console output (e.g. progress bars).
-v
--verbose
More verbose output. Use twice for even more verbose output.
-m
--machine
Apply the configuration machine-wide (for the entire computer) instead of just for the current user.

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 Hide the graphical user interface and use something like a tray icon instead. Has no effect in command-line mode.
--batch Automatically answer questions with defaults when possible. Avoid unnecessary console output (e.g. progress bars).
-v
--verbose
More verbose output. Use twice for even more verbose output.
--customize 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: *, Linux, Solaris, FreeBSD, MacOSX, Darwin, Cygwin, POSIX, 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, unknown
--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.
-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 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.
--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.

select

Selects a version of the program identified by URI, and compatible versions of all of its dependencies.

Returns an exit status of zero 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 Hide the graphical user interface and use something like a tray icon instead. Has no effect in command-line mode.
--batch Automatically answer questions with defaults when possible. Avoid unnecessary console output (e.g. progress bars).
-v
--verbose
More verbose output. Use twice for even more verbose output.
--customize 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: *, Linux, Solaris, FreeBSD, MacOSX, Darwin, Cygwin, POSIX, 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, unknown
--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 Hide the graphical user interface and use something like a tray icon instead. Has no effect in command-line mode.
--batch Automatically answer questions with defaults when possible. Avoid unnecessary console output (e.g. progress bars).
-v
--verbose
More verbose output. Use twice for even more verbose output.
--customize 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: *, Linux, Solaris, FreeBSD, MacOSX, Darwin, Cygwin, POSIX, 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, unknown
--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 Hide the graphical user interface and use something like a tray icon instead. Has no effect in command-line mode.
--batch Automatically answer questions with defaults when possible. Avoid unnecessary console output (e.g. progress bars).
-v
--verbose
More verbose output. Use twice for even more verbose output.
--customize 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: *, Linux, Solaris, FreeBSD, MacOSX, Darwin, Cygwin, POSIX, 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, unknown
--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.

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 Hide the graphical user interface and use something like a tray icon instead. Has no effect in command-line mode.
--batch Automatically answer questions with defaults when possible. Avoid unnecessary console output (e.g. progress bars).
-v
--verbose
More verbose output. Use twice for even more verbose output.
--customize 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: *, Linux, Solaris, FreeBSD, MacOSX, Darwin, Cygwin, POSIX, 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, unknown
--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.
-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 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 Hide the graphical user interface and use something like a tray icon instead. Has no effect in command-line mode.
--batch Automatically answer questions with defaults when possible. Avoid unnecessary console output (e.g. 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 Hide the graphical user interface and use something like a tray icon instead. Has no effect in command-line mode.
--batch Automatically answer questions with defaults when possible. Avoid unnecessary console output (e.g. progress bars).
-v
--verbose
More verbose output. Use twice for even more verbose output.
--customize 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: *, Linux, Solaris, FreeBSD, MacOSX, Darwin, Cygwin, POSIX, 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, unknown
--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.
--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 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 trust the programs before running them.

Usage: 0install search QUERY

Option Description
-?
-h
--help
Show the built-in help text.
--background Hide the graphical user interface and use something like a tray icon instead. Has no effect in command-line mode.
--batch Automatically answer questions with defaults when possible. Avoid unnecessary console output (e.g. 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 Hide the graphical user interface and use something like a tray icon instead. Has no effect in command-line mode.
--batch Automatically answer questions with defaults when possible. Avoid unnecessary console output (e.g. 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 Hide the graphical user interface and use something like a tray icon instead. Has no effect in command-line mode.
--batch Automatically answer questions with defaults when possible. Avoid unnecessary console output (e.g. 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 Hide the graphical user interface and use something like a tray icon instead. Has no effect in command-line mode.
--batch Automatically answer questions with defaults when possible. Avoid unnecessary console output (e.g. 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 Hide the graphical user interface and use something like a tray icon instead. Has no effect in command-line mode.
--batch Automatically answer questions with defaults when possible. Avoid unnecessary console output (e.g. 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 Hide the graphical user interface and use something like a tray icon instead. Has no effect in command-line mode.
--batch Automatically answer questions with defaults when possible. Avoid unnecessary console output (e.g. 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 Hide the graphical user interface and use something like a tray icon instead. Has no effect in command-line mode.
--batch Automatically answer questions with defaults when possible. Avoid unnecessary console output (e.g. 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 Hide the graphical user interface and use something like a tray icon instead. Has no effect in command-line mode.
--batch Automatically answer questions with defaults when possible. Avoid unnecessary console output (e.g. 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 Hide the graphical user interface and use something like a tray icon instead. Has no effect in command-line mode.
--batch Automatically answer questions with defaults when possible. Avoid unnecessary console output (e.g. 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' 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 Hide the graphical user interface and use something like a tray icon instead. Has no effect in command-line mode.
--batch Automatically answer questions with defaults when possible. Avoid unnecessary console output (e.g. 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 Hide the graphical user interface and use something like a tray icon instead. Has no effect in command-line mode.
--batch Automatically answer questions with defaults when possible. Avoid unnecessary console output (e.g. 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 Hide the graphical user interface and use something like a tray icon instead. Has no effect in command-line mode.
--batch Automatically answer questions with defaults when possible. Avoid unnecessary console output (e.g. progress bars).
-v
--verbose
More verbose output. Use twice for even more verbose output.

add

Add an application to the application list.

Usage: 0install add [OPTIONS] INTERFACE

Option Description
-?
-h
--help
Show the built-in help text.
--background Hide the graphical user interface and use something like a tray icon instead. Has no effect in command-line mode.
--batch Automatically answer questions with defaults when possible. Avoid unnecessary console output (e.g. 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
Apply the configuration machine-wide (for the entire computer) instead of just for the current user.
--no-download 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] (PET-NAME|INTERFACE)

Option Description
-?
-h
--help
Show the built-in help text.
--background Hide the graphical user interface and use something like a tray icon instead. Has no effect in command-line mode.
--batch Automatically answer questions with defaults when possible. Avoid unnecessary console output (e.g. 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
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 Hide the graphical user interface and use something like a tray icon instead. Has no effect in command-line mode.
--batch Automatically answer questions with defaults when possible. Avoid unnecessary console output (e.g. 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
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] (PET-NAME|INTERFACE)

Option Description
-?
-h
--help
Show the built-in help text.
--background Hide the graphical user interface and use something like a tray icon instead. Has no effect in command-line mode.
--batch Automatically answer questions with defaults when possible. Avoid unnecessary console output (e.g. 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
Apply the configuration machine-wide (for the entire computer) instead of just for the current user.
--no-download 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 Hide the graphical user interface and use something like a tray icon instead. Has no effect in command-line mode.
--batch Automatically answer questions with defaults when possible. Avoid unnecessary console output (e.g. 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
Apply the configuration machine-wide (for the entire computer) instead of just for the current user.
--no-download 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 Hide the graphical user interface and use something like a tray icon instead. Has no effect in command-line mode.
--batch Automatically answer questions with defaults when possible. Avoid unnecessary console output (e.g. 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
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 Hide the graphical user interface and use something like a tray icon instead. Has no effect in command-line mode.
--batch Automatically answer questions with defaults when possible. Avoid unnecessary console output (e.g. 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
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 Hide the graphical user interface and use something like a tray icon instead. Has no effect in command-line mode.
--batch Automatically answer questions with defaults when possible. Avoid unnecessary console output (e.g. 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
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 Hide the graphical user interface and use something like a tray icon instead. Has no effect in command-line mode.
--batch Automatically answer questions with defaults when possible. Avoid unnecessary console output (e.g. 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
Apply the configuration machine-wide (for the entire computer) instead of just for the current user.
--reset MODE Reset the synchronization data. Possible MODEs are '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 Hide the graphical user interface and use something like a tray icon instead. Has no effect in command-line mode.
--batch Automatically answer questions with defaults when possible. Avoid unnecessary console output (e.g. 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
Apply the configuration machine-wide (for the entire computer) instead of just for the current user.
--no-download Do not download the application itself yet. Will be automatically downloaded on first use instead.

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 Hide the graphical user interface and use something like a tray icon instead. Has no effect in command-line mode.
--batch Automatically answer questions with defaults when possible. Avoid unnecessary console output (e.g. 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 Hide the graphical user interface and use something like a tray icon instead. Has no effect in command-line mode.
--batch Automatically answer questions with defaults when possible. Avoid unnecessary console output (e.g. 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 Hide the graphical user interface and use something like a tray icon instead. Has no effect in command-line mode.
--batch Automatically answer questions with defaults when possible. Avoid unnecessary console output (e.g. 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 Hide the graphical user interface and use something like a tray icon instead. Has no effect in command-line mode.
--batch Automatically answer questions with defaults when possible. Avoid unnecessary console output (e.g. 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 Hide the graphical user interface and use something like a tray icon instead. Has no effect in command-line mode.
--batch Automatically answer questions with defaults when possible. Avoid unnecessary console output (e.g. 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 Hide the graphical user interface and use something like a tray icon instead. Has no effect in command-line mode.
--batch Automatically answer questions with defaults when possible. Avoid unnecessary console output (e.g. 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 Hide the graphical user interface and use something like a tray icon instead. Has no effect in command-line mode.
--batch Automatically answer questions with defaults when possible. Avoid unnecessary console output (e.g. 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 Hide the graphical user interface and use something like a tray icon instead. Has no effect in command-line mode.
--batch Automatically answer questions with defaults when possible. Avoid unnecessary console output (e.g. 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 Hide the graphical user interface and use something like a tray icon instead. Has no effect in command-line mode.
--batch Automatically answer questions with defaults when possible. Avoid unnecessary console output (e.g. 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 Hide the graphical user interface and use something like a tray icon instead. Has no effect in command-line mode.
--batch Automatically answer questions with defaults when possible. Avoid unnecessary console output (e.g. 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 employed 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 Hide the graphical user interface and use something like a tray icon instead. Has no effect in command-line mode.
--batch Automatically answer questions with defaults when possible. Avoid unnecessary console output (e.g. 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 Hide the graphical user interface and use something like a tray icon instead. Has no effect in command-line mode.
--batch Automatically answer questions with defaults when possible. Avoid unnecessary console output (e.g. 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. it manifest digest has not changed).

Usage: 0install store verify [DIRECTORY] DIGEST

Option Description
-?
-h
--help
Show the built-in help text.
--background Hide the graphical user interface and use something like a tray icon instead. Has no effect in command-line mode.
--batch Automatically answer questions with defaults when possible. Avoid unnecessary console output (e.g. 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 Hide the graphical user interface and use something like a tray icon instead. Has no effect in command-line mode.
--batch Automatically answer questions with defaults when possible. Avoid unnecessary console output (e.g. progress bars).
-v
--verbose
More verbose output. Use twice for even more verbose output.
-m
--machine
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 Hide the graphical user interface and use something like a tray icon instead. Has no effect in command-line mode.
--batch Automatically answer questions with defaults when possible. Avoid unnecessary console output (e.g. progress bars).
-v
--verbose
More verbose output. Use twice for even more verbose output.
-m
--machine
Apply the configuration machine-wide (for the entire computer) instead of just for the current user.

maintenance deploy

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

Usage: 0install maintenance deploy [TARGET]

Option Description
-?
-h
--help
Show the built-in help text.
--background Hide the graphical user interface and use something like a tray icon instead. Has no effect in command-line mode.
--batch Automatically answer questions with defaults when possible. Avoid unnecessary console output (e.g. progress bars).
-v
--verbose
More verbose output. Use twice for even more verbose output.
-m
--machine
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.

maintenance remove

Removes the current instance of Zero Install from the system.

Usage: 0install maintenance remove

Option Description
-?
-h
--help
Show the built-in help text.
--background Hide the graphical user interface and use something like a tray icon instead. Has no effect in command-line mode.
--batch Automatically answer questions with defaults when possible. Avoid unnecessary console output (e.g. progress bars).
-v
--verbose
More verbose output. Use twice for even more verbose output.