3.5.1 Matrix Server Command Reference

Chapter 2: mx Commands 56

The entries in the matrixrc file have this format:

machine user password default

• The first field, machine, is either the name or IP address of the server.

• The second field, user, is optional. It 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 also optional and contains the Matrix Server password

for that user. The password is encrypted automatically when you use the

Matrix Server Connect window to specify the password.

NOTE: In Matrix Server releases earlier than 3.x, the mx command cannot

interpret encrypted passwords. If you are using mx and connect to

a matrix running one of these versions of Matrix Server, you will be

asked whether you want Matrix Server to create a temporary

.matrixrc file that contains clear passwords. The temporary file will

be deleted when the mx command is complete.

•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.

NOTE: Comments can be lost when the .matrixrc file is edited via the Matrix

Server Connect window.

Specify servers in the .matrixrc file

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

servers individually in the matrixrc file or use the mx --matrix command-line

option. If any server can be used, 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