Skip to content

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.
trust add
(Windows only)
Trusts feeds from a specific `DOMAIN` when [signed](../specifications/feed.md#digital-signatures) with a specific `FINGERPRINT`.
trust remove
(Windows only)
Stops trusting feeds [signed](../specifications/feed.md#digital-signatures) with a specific `FINGERPRINT`. Only stops trusting for a specific `DOMAIN`, if specified.
trust list
(Windows only)
List keys trusted for [signing](../specifications/feed.md#digital-signatures) feeds. Only list domains for which a specific `FINGERPRINT` is trusted, if specified.
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 serve
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 output 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

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.

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.

trust add

Trusts feeds from a specific DOMAIN when signed with a specific FINGERPRINT.

Usage: 0install trust add FINGERPRINT DOMAIN

Option Description
-?
-h
--help
Show the built-in help text.
--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.

trust remove

Stops trusting feeds signed with a specific FINGERPRINT. Only stops trusting for a specific DOMAIN, if specified.

Usage: 0install trust remove FINGERPRINT [DOMAIN]

Option Description
-?
-h
--help
Show the built-in help text.
--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.

trust list

List keys trusted for signing feeds. Only list domains for which a specific FINGERPRINT is trusted, if specified.

Usage: 0install trust list [FINGERPRINT]

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.

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 serve

Serves implementations from the cache as archives via HTTP

Usage: 0install store serve [PORT]

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: capability-registration, menu-entry, desktop-icon, send-to, alias, auto-start, default-access-point
--remove-all Remove all access points.
--remove CATEGORY Remove all access points of a specific CATEGORY.
Supported values: capability-registration, menu-entry, desktop-icon, send-to, alias, auto-start, default-access-point

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 an URI is given, only the application with that feed URI is shown. If a PATTERN is given, only applications containing that string in their name are shown (case insensitive).

Usage: 0install list-apps [URI|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.
--xml Write output to console as machine-readable XML.

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.