Command Reference Guide

Chapter 2: mx Commands 55

• The second field, user, is the name of a user on that server, either admin for

the administrator or another name for a read-only user.

• The third field is the Matrix Server password for that user.

• The fourth field, default, specifies that this server will be connected to by

default if a server name is not specified on the command line. Specifying a

default server is optional.

Blank lines and lines beginning with a # character are ignored.

If you need to control which server is used for the mx connection, list the

servers individually in the matrixrc file. If any server can be used for the

connection, you can group the servers.

List servers individually

Add a line to the file for each server for which you want mx access and

specify the appropriate username and password. This example specifies that

srv3 is the default.

srv1 admin secret1

srv2 admin secret1

srv3 admin secret2 default

When you issue a mx command without specifying a server name, as in the

following example, it connects to the machine specified as the default in the

.matrixrc file.

mx server status

To connect to a different server, include the --matrix option and specify the

server name on the command line. For example, the following command

connects to server acme1 as user admin using the password secret1.

mx --matrix srv1 server status

Use wildcards

You can use wildcards in the .matrixrc file to match machine names:

srv* admin secret1

srv3 admin secret1 default