{"data":{"markdownRemark":{"html":"<p>Each of these setup processes can be done with user-wide authentication or project-local authentication. Although most modellers need user-wide authentication, there may be instances where a different license is necessary in one or more specific projects. The setup processes go through user-wide setup first, followed by project-local setup.</p>\n<h2 id=\"maven-authentication\"><a href=\"#maven-authentication\" aria-hidden=\"true\" class=\"anchor\"><svg aria-hidden=\"true\" height=\"16\" version=\"1.1\" viewBox=\"0 0 16 16\" width=\"16\"><path fill-rule=\"evenodd\" d=\"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"></path></svg></a>Maven Authentication</h2>\n<p>Maven will search for a file called <code class=\"language-text\">settings.xml</code> in its home directory when creating a default server authentication configuration.</p>\n<p>Use the following commands to create and open the Maven home directory, <code class=\"language-text\">.m2</code> directory, if it hasn't been created already.</p>\n<p>On a <i class=\"windows icon\"></i> Windows command prompt (WinKey + R, <code class=\"language-text\">cmd</code>), run the following commands.</p>\n<div class=\"gatsby-highlight\" data-language=\"text\"><pre class=\"language-text\"><code class=\"language-text\">md &quot;%userprofile%\\.m2&quot;\nexplorer &quot;%userprofile%\\.m2&quot;</code></pre></div>\n<p>On <i class=\"apple icon\"></i> Mac OS and <i class=\"linux icon\"></i> Linux, run the following commands.</p>\n<div class=\"gatsby-highlight\" data-language=\"text\"><pre class=\"language-text\"><code class=\"language-text\">mkdir -p ~/.m2\n\nopen ~/.m2 # MacOS\nxdg-open ~/.m2 # Linux</code></pre></div>\n<p>Next, if <code class=\"language-text\">settings.xml</code> doesn't exist in that directory, create it. The basic structure of the file should look like the following.</p>\n<div class=\"gatsby-highlight\" data-language=\"text\"><pre class=\"language-text\"><code class=\"language-text\">&lt;?xml version=&quot;1.0&quot; encoding=&quot;UTF-8&quot;?&gt;\n&lt;settings&gt;\n    &lt;servers&gt;\n        &lt;server&gt;\n            &lt;id&gt;simudyne.jfrog.io&lt;/id&gt;\n            &lt;username&gt;&lt;/username&gt;\n            &lt;password&gt;&lt;/password&gt;\n        &lt;/server&gt;\n    &lt;/servers&gt;\n&lt;/settings&gt;</code></pre></div>\n<p>Place your username and password in the appropriate XML elements, then save the file. The username and password are located in your Maven access token file. </p>\n<p>The format of the Maven access token file has changed slightly over time. For older Simudyne users, the username is the name of the access token file, and the password is the file content. Newer users can find both the username and passowrd in the contents of the access token file, as the first and second line, respectively.</p>\n<p>Your organisation may require you to use a proxy for Maven requests. Proxy settings should be placed in the settings.xml file under the \"proxies\" element. For more information on configuring a proxy, see Maven's\n<a href=\"https://maven.apache.org/guides/mini/guide-proxies.html\" target=\"_blank\" rel=\"noopener\">proxy configuration page</a>.</p>\n<p>There are two different ways Maven can be configured for project-local authentication.</p>\n<ol>\n<li>On the command line,  pass <code class=\"language-text\">-S settings.xml</code> to any <code class=\"language-text\">mvn</code> command.</li>\n<li>In the IDE, override the Maven configuration on a per-project basis. The exact method for this will vary depending on the IDE. For IntelliJ Idea, Simudyne's recommended IDE, take the following steps:\na. Go to \"Build, Execution, Deployment\".\nb. In \"Build Tools\", select \"Maven\".\nc. Tick the override box for the \"User settings file\" property.\nd. Set it to point to the <code class=\"language-text\">settings.xml</code> file in your project.</li>\n</ol>\n<h2 id=\"simudyne-license\"><a href=\"#simudyne-license\" aria-hidden=\"true\" class=\"anchor\"><svg aria-hidden=\"true\" height=\"16\" version=\"1.1\" viewBox=\"0 0 16 16\" width=\"16\"><path fill-rule=\"evenodd\" d=\"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"></path></svg></a>Simudyne License</h2>\n<p>SDK users should recieve a Simudyne license file as part of the onboarding process. Please contact <strong>support@simudyne.com</strong> if there are any license problems.</p>\n<p>Simudyne licenses have a <code class=\"language-text\">.license</code> extension, and the SDK automatically searches for licenses in the <code class=\"language-text\">.simudyne</code> directory. If the directory contains more than one license file, the SDK will pick one at random.</p>\n<p>Read more in-depth documentation on licensing <a href=\":version/reference/licensing\">here</a>.</p>\n<p>Use the following commands to create and open the <code class=\"language-text\">.simudyne</code> directory. Put the license file inside after the directory has been created.</p>\n<p>On a <i class=\"windows icon\"></i> Windows command prompt (WinKey + R, <code class=\"language-text\">cmd</code>), run the following commands.</p>\n<div class=\"gatsby-highlight\" data-language=\"text\"><pre class=\"language-text\"><code class=\"language-text\">md &quot;%userprofile%\\.simudyne&quot;\nexplorer &quot;%userprofile%\\.simudyne&quot;</code></pre></div>\n<p>On <i class=\"apple icon\"></i> Mac OS and <i class=\"linux icon\"></i> Linux, run the following commands.</p>\n<div class=\"gatsby-highlight\" data-language=\"text\"><pre class=\"language-text\"><code class=\"language-text\">mkdir -p ~/.simudyne\n\nopen ~/.simudyne # MacOS\nxdg-open ~/.simudyne # Linux</code></pre></div>\n<p>There are several ways that Simudyne licenses can be configured for project-local authentication.</p>\n<ol>\n<li>Copy the license to a project's root directory and rename it to  `licenseKey'. The SDK will then prioritize this license.</li>\n<li>Put a <code class=\"language-text\">core.license-file</code> property into the <code class=\"language-text\">simudyneSDK.properties</code> file. The value should be the path to your license relative to your project root directory.</li>\n<li>Pass in the license location via the Java command line using the <code class=\"language-text\">-DsimudyneLicenseFile</code> flag.</li>\n</ol>","headings":[{"value":"Maven Authentication","depth":2},{"value":"Simudyne License","depth":2}],"frontmatter":{"title":"Setup","toc":true,"experimental":null}},"site":{"siteMetadata":{"title":"Simudyne Docs","latestVersion":"2.6"}}},"pageContext":{"absolutePath":"/home/vsts/work/1/s/content/2.3/docs/overview/download.md","versioned":true,"version":"2.3","kind":"docs","pagePath":"/overview/download","chronology":{"prev":{"name":"Requirements","path":"/overview/requirements"},"next":{"name":"Tutorials","path":"/tutorials"}},"lastUpdated":"2026-04-21T13:56:54.840Z"}}