Registering SAM

1 post / 0 new
Paul Gilman
Registering SAM

When you start SAM for the first time after installing it, it displays the SAM Registration window where you provide an email address to register your copy of SAM. Registration is free, and allows us to keep count of how many people are using SAM. We use this information in our reports to the U.S. Department of Energy, which funds NREL's work on SAM, making it possible for you to use the software for free.

To register SAM:

SAM Registration Window

  1. Type your email in the Registration window and click Register. You should receive an email from SAM Support with a registration key.
  2. Paste the key from the email into the Registration window and click Confirm. Be careful not to include any spaces at the end of the key when you select it to copy.
  3. In the Registration Information window, click OK to finish registering or Cancel to cancel the registration. If you do not see the OK and Cancel buttons, press the Enter key on your keyboard to register, or close the window to cancel.

SAM requires an internet connection to complete the registration process. The registration process may fail if your computer uses a firewall or proxy server to connect to the internet. If you have trouble registering SAM, please try the following to configure your firewall or to configure SAM to use your proxy server. If you continue to have trouble, please email us.

Configure your Firewall to Allow SAM to Connect to Registration Server

If your computer connects to the internet through a firewall, you may need to create an exception to allow SAM to connect to the NREL server that stores registration information. SAM uses standard HTTP, HTTPS, and SMTP (mailto:) protocols to access the internet. The URL for the registration server is

If you plan to use other SAM features that connect to the internet, you may need to add other URLs to the list of firewall exceptions. You can find a list of all URLs SAM uses in SAM's Help system, under Reference, Web Access and Proxies, or in the webapis.conf file in the runtime folder of your SAM installation.

Configure SAM to Work with a Proxy Server

If your computer uses a web proxy server to connect to the internet, you can create a proxy configuration file that will allow SAM to connect using your proxy server address. You can either create the file in a text editor, or use SAM's proxy configuration window as described below. The file is named proxy.txt and contains a single line with the proxy server URL and optional custom port as described in the instructions below. The file should be in the folder that contains the SAM executable file in your SAM installation folder.

To remove the proxy configuration, either delete the proxy.txt file, or delete the proxy server URL from the proxy configuration window.

To create a proxy configuration file:

  1. Start SAM.
  2. If you do not see the Registration window, click Registration in the bottom left corner of the Welcome page. If SAM is open, close the current project to display the Welcome page.
  3. In the Registration window, type the email address and registration key if the fields are empty. If you do not have a key, register to request one as described above.
  4. Click Proxies.
  5. In the Configure Proxy window, type the proxy server's URL. For example, if the server's address is "," type:

    Configure Proxy window with no port specified

    To specify a custom port, add it to the name with a colon separator (no spaces). For example, if the server address is "," and the custom port number is 1234, type:

    Configure proxy window with custom port

  6. Click OK to close the Configure Proxy window, and Close to return to the SAM main window.


Best regards,


Theme by Danetsoft and Danang Probo Sayekti inspired by Maksimer