Web access and Proxy server setup

This is one of those things. It should be straightforward.

When RIMMF tries to access HTML content (RIMMF user guide, RDA Toolkit, etc.), it uses the default internet settings on your computer. For example, when you press F1 to open the RIMMF user guide, RIMMF simply opens the page in (a stripped down version of) your default browser.

However, when RIMMF tries to access cataloging data, it makes a more direct request to the site in question (LC, VIAF, etc.).

We think in the current computing environment, such direct requests will also be automatically redirected through a proxy server where applicable.

However, if you find that you need to manually setup a proxy server, use the steps below.

1. Find the options file

The RIMMF options are located in a file named 'options.ini' in your RIMMF3 folder.
In a standard installation, this 'RIMMF3' folder is located in your My Documents area;
for a zip installation, please use these steps to locate the My Documents surrogate).

2. When RIMMF is not running, open 'options.ini' in a text editor

In most cases, Windows will open this type of file in Notepad

3. Find the line that begins


4. Add your information after the '=' with no extra spaces. This should contain the servername or IP Address, followed by a colon, followed by a port number. For example

5. If you also need to specify a username and/or password for your proxy server, you may set them in the same way (beginning with release 160325), by finding the two lines that follow, and entering the appropriate information:


Non-ascii characters in either the username or password must be \u encoded ('\u' + the UTF-16 code in hex).
So, instead of España, you should type:


If you need to look up the codes, try this site: http://www.fileformat.info/info/unicode/char/a.htm

6. Finally, there is an option to specify the type of authentication. By default it is off (or set to 0), but when a username and password are added, it will be set to 'Basic' (which is 1); additionally, the user can set it to 'NTLM' or 'Digest', as follows

proxyAuthType=2  [for NTLM]


proxyAuthType=3  [for Digest]

7. When you are done, save the options file

howto/proxyserver.txt · Last modified: 2023/06/07 20:39 by
Back to top
CC Attribution-Share Alike 4.0 International
Driven by DokuWiki