Get Started - Source code

Obtaining the source code

The ADAMS source code is hosted in the following subversion repository:

You can check out the code ("trunk") in the console with the following command:

svn checkout adams

Anonymous access

The subversion repository allows public or anonymous read access. When performing a checkout, subversion will usually use your user name to perform the checkout and ask for a password for this user (in the example below, this is fracpete). Simply hit Enter and when prompted for user name, use anonymous with an empty password.

mymachine:~/tmp>svn checkout adams
Authentication realm: <> Subversion repository
Password for 'fracpete':

Authentication realm: <> Subversion repository
Username: anonymous
Password for 'anonymous':

A    adams/adams-twitter
A    adams/adams-twitter/LICENSE.txt
A    adams/adams-twitter/src
A    adams/adams-twitter/src/test

Other modules

Further modules are available:

Compiling the source code

ADAMS uses Maven as build tool. See the Requirements section for more details on what you need for compiling the code.

Download the settings.xml file and place it in the following directory (if you are behind a proxy, see section Proxy below):

  • Linux/Unix/Mac:


  • Windows:


You need to set the environment variable JAVA_TOOL_OPTIONS to -Djsse.enableSNIExtension=false to avoid the Server SSL Error - handshake alert: unrecognized_name error message.

Also recommended, is adding the following parameter to the JAVA_TOOL_OPTIONS in order to always get a full strack traces whenever an error occurs: -XX:-OmitStackTraceInFastThrow

You can compile the source code in the console as follows:

mvn clean install

If you want to skip the tests, use the following:

mvn clean install -DskipTests=true

This will generate a ZIP archive in the target directory of the adams-base-all module that contains all the jars and scripts to start ADAMS and the generated documentation.


If your LaTeX binaries (e.g., pdflatex) aren't on the system's path, you need to modify the latex.binariesPath property of the latex profile in the settings.xml file. For instance, if your LaTeX binaries are located in:


Then adapt the latex.binariesPath as follows:



If you are behind a proxy, you need to tell Maven about it. Let's assume that your proxy is called and its port 3128.

If you don't need a password to connect to it, you can add the following tag to your settings.xml file:


If your proxy requires a user/password, then you have to 1) generate a master password with Maven (which gets stored in your home directory's .m2/settings-security.xml file) and then 2) the actual password for the proxy. The details are explained here on the Maven homepage. Once you've created the passwords, you have to add the following tag to your settings.xml file and replace the USER and ENCRYPTED_PASSWORD placeholders accordingly.