- MiKTeX Docs

Name

mpm — MiKTeX package manager

Synopsis

mpm [option...]

Description

MPM starts in windowed mode, if you do not specify any command-line options.

User mode vs. administrator mode

This utility can be run in two modes:

User mode (default): MPM operates on the user installation directory (usually %LOCALAPPDATA%\Programs\MiKTeX 2.9).
Administrator mode: MPM operates on the system-wide installation directory (usually C:\Program Files\MiKTeX 2.9), assuming that the MiKTeX setup is shared by all users. MPM must be run with administrator privileges.

By default, MPM runs in user mode. You can turn on administrator mode with the --admin option. For example, if you want to install a package for all users, you invoke MPM as follows:

> mpm --admin --install=a0poster

Options

--admin

Run in administrator mode:

Operate on the system-wide MiKTeX configuration data store.
Install packages for all users.

Using this option requires a shared MiKTeX setup, i.e., MiKTeX must have been set up for all users. The program must be run with administrator privileges.

--help

Give help and exit.

--hhelp

This option is only available on Windows systems: show the manual page in an HTML Help window and exit when the window is closed.

--import=package

Import the specified package from another MiKTeX installation. The root directory must be specified via --repository=dir.

--import-all

Import all packages from another MiKTeX installation. The root directory must be specified via --repository=dir.

--pick-repository-url

Pick up a suitable URL from the package repository list and print it.

--quiet

Suppress all output, except errors.

--repository=location

Use the specified location as the package repository. The location can be either a fully qualified path name (a local package repository) or an URL (a remote package repository).

--repository-release-state=state

Select the release state of the remote package repository. The release state is relevant for finding appropriate package repositories. The release state must be one of stable or next.

--set-repository=location

Store the location of the default package repository in the MiKTeX configuration data store. The location can be either a fully qualified path name (a local package repository) or an URL (a remote package repository).

--trace[=tracestreams]

Enable trace messages. The tracestreams argument, if specified, is a comma-separated list of trace stream names (Chapter 9, Trace Streams).

--verbose

Turn on verbose output mode.

--version

Show version information and exit.

Environment

MIKTEX_REPOSITORY: Location of the default package repository. This can be either a fully qualified path name (a local package repository) or an URL (a remote package repository).
MIKTEX_TRACE: Comma-separated list of trace stream names (see Chapter 9, Trace Streams). If this variable is set, then MiKTeX programs will write trace messages into the configured log sink.
http_proxy: The proxy server to be used for HTTP.
FTP_PROXY: The proxy server to be used for .
ALL_PROXY: The proxy server to be used, if no protocol-specific proxy is set.
NO_PROXY: Comma-separated list of host names that should not go through any proxy.