Lesson 1: Installing and Starting Nexus Repository Manager

This lesson provides you with all the information necessary to start the Nexus Repository Manager 3 OSS (NXRM).

Learning Objectives


By the end of this thirty minute lesson, you will be able to:

  • Download the latest version of NXRM
  • Unpack the archive and start the NXRM
  • Sign in and update the default administrative credentials
  • Sign out and shut down the repository

In This Lesson:

Downloading the Repository Manager


In order to practice using Nexus Repository Manager 3 in this lesson, you will need to create an installation directory. This is where you can download and store your instance of the repository manager. The installation directory will serve as the common parent location for all files needed to install and run NXRM. - Download the repository manager via these steps:

  1. Create an installation directory on your computer.

    Best practice is to create your installation directory in a directory other than your user home directory and outside of the Program Files directory. You can install the repository manager in a directory other than your users home directory. On a Unix machine common practice is to use /opt.

  2. Navigate to the Download page in our help documentation to access the latest version of Nexus Repository Manager The latest version of the download file is displayed below. This example uses version 3.10.0-04.
  3. Click the Link for Download according to your operating system. The packed/zipped file is downloaded to your computer.

You have now successfully created an installation directory and downloaded NXRM. Next, we will unpack the file and launch NXRM via the startup script.

Unpacking the File and Launching NXRM3


After successfully downloading the NXRM file, unpack the compressed files into the file directory that you created in the section above. From that point, you will be able to launch the repository by running the startup script.

  1. Unpack the archive file into the directory you created in the previous section. From the command line use tar xvzf nexus-<version>.<tar file extension> to extract the repository manager.
  2. Locate the startup script for NXRM in the directory you created earlier in this lesson. You will find the startup script in the folder nexus-<version>/bin/ as pictured above. (This example uses a Linux platform.)

    The bin folder contains the generic startup scripts for Unix-like platforms called nexus. The Windows platform equivalent is called nexus.exe.

  3. Start NXRM by running the file nexus from your command line. To start the repository manager from application directory in the bin folder perform one of the following:
    1. on a Unix-like platform like Linux use the command: ./nexus run
    2. in Windows, use the command: nexus.exe /run

    Starting the repository manager with the run command will leave it running in the current shell and display the log output.

    The file is launched, and when complete, the log file displays a message “Started Sonatype Nexus.” You are now able to start the repository manager.

  4. Open your browser and type in the URL: http://localhost:8081/. The Nexus Repository Manager Welcome screen displays.

The Welcome screen (aka Outreach page) provides important links and notifications regarding the repository manager. On this page you might find details about upcoming user conferences, release notes, and surveys, among other things. Navigating the user interface is covered in a separate module.

You have successfully unpacked and started NXRM 3 OSS. Up next you'll sign in to the Repository Manager and change the default credentials.

Signing In to NXRM and Changing the Default Credentials


Signing In

The first time you sign in to NXRM you will use the default username and password. It is best practice to change this default to more secure credentials, private to you.

  1. From the NXRM Welcome screen, click Sign in. A Sign in pop up box is displayed.
  2. Enter the default username, which is “admin” and default password, which is “admin123.”
  3. Click Sign in. The Sign in dialog box is closed, and you are signed in into NXRM.

Changing Your Default Account Profile

The first time you login to NXRM, it is best practice to change the default credentials, including your first and last name, and email address. After logging in with the default username and password, complete the following steps.

  1. From the NXRM Welcome screen, click Admin. The Manage Your Account screen is displayed.

  2. Enter your first name, last name, and email address in the appropriate open text fields.
  3. Click Save. The screen refreshes and your account information is updated.

Changing Your Default Password

The first time you login to NXRM, it is best practice to change the default password. After signing in with the default username and password (admin/admin123), complete the following steps.

  1. From the Account screen, click Change password. The Authenticate dialog box is displayed.
  2. Enter your current password in the open text field.
  3. Click Authenticate. The Change Password dialog box is displayed.
  4. Enter a new password in the New password field.
  5. Confirm the new password by entering it in again in the Confirm password field.
  6. Click Change password. The dialog box is closed, and you have successfully changed your password.

You have now successfully logged in to NXRM and changed the default credentials. Up next you'll learn how to sign out of NXRM and shut down the application via the command line.

Signing Out and Shutting Down the Repository


In order to shut down the repository manager running via the run command, there are a few things to do. First, sign out of NXRM, then shut down via the command line. The steps to do so are described below.

  1. Click Sign out. The screen refreshes and you are signed out of NXRM. You may close the browser window.
  2. Navigate to your command line.
  3. To shut down the repository manager use the command line CTRL+C.

Activity: Test your Knowledge

  1. In order to practice using NXRM, you need to create an installation ___________________ and download the appropriate NXRM file for your _______________ ________________.
    Choose only ONE answer.
    1. directory; operating system
    2. password; operating system
    3. data; application directory
    4. directory; data directory
  2. True or False: To shut down the repository, simply click Sign out in the upper right corner of the screen.

 Answer Key
  1. A
  2. False. After you sign out of NXRM, you also need to shut down via the command line.

You have successfully completed the first lesson. Up next, you'll learn how to proxy a Maven repository and create hosted Maven repositories in Lesson 2.

← Course Overview
  Lesson 2 →