Ensure that you are logged in as an Admin to the Artifactory UI of the Artifactory service that you want to setup Users, Repositories, Permissions, and Groups for.

• http://<artifactory server>/artifactory/webapp/#/home

⚠️ This guide is applicable for Artifactory OSS version 6.x.

 

Users

In order for one to use Artifactory, one must have a userid on Artifactory. This section explains how to create a User in Artifactory

• Click on Admin on the far left menu to open all of the administrative settings.
• From the menu of administrative settings, click on Users under the Security section.
• From the Users Management page, click on the New button located in the top right-hand corner.
• From the Add New User page, configure the following:
  • User Name (required)
  • Email Address (required)
  • High Level Permissions (optional. Check the desired checkboxes below the "User Name" and "Email Address" fields to configure these permissions)
  • Password (required unless the "Disable Internal Password" checkbox above this field is checked.)
  • Related Groups (optional)
  • User Permissions (optional, these are more advanced options)
• When done configuring the User, click the green button labeled Save on the bottom right-hand corner.

 

Repositories

In order to store artifacts in Artifactory, one must first have a Repository that they can use to store those artifacts in. This guide explains how to create a Repository in Artifactory.

Note that you can create Local, Remote, Virtual, and Distribution Repositories. This guide only covers how to create a Local Repository. See the JFrog Repository Management documentation for details on the other repository types.

• Click on Admin on the far left menu to open all of the administrative settings.
• From the menu of administrative settings, click on Local under the Repositories section.
• From the Local Repositories page, click on the New button located in the top right-hand corner.
• From the New Local Repository page, select a Package Type from the pop-up. Select a Package type that best fits the type of artifacts that you will be storing in the Repository.
• Fill the rest of the following fields on the New Local Repository page (Don't worry about the Advnaced and Replications configuration unless you need them. They are not covered in this wiki, and they are optional.):
  • Repository Key (required)
  • Repository Layout (optional)
  • Public Description (optional)
  • Internal Description (optional)
  • Include Patterns (optional)
  • Exclude Patterns (optional)
• When done configuring the Repository, click the green button labeled Save & Finish on the bottom right-hand corner.

 

Permissions

Unless a User is an Admin, they will need Permissions configured giving them access to Repositories.

• Click on Admin on the far left menu to open all of the administrative settings.
• From the menu of administrative settings, click on Permissions under the Security section.
• From the Permissions Management page, click on the Add New Permission button located in the top right-hand corner.
• From the New Permission page, you must at a bare minimum, give the Permission and name, and add at least one Repository. However, you may configure multiple Repositories, Users, and Groups for any given Permission. To add Repositories, Users, and Groups to a Permission, move the entities that you want to add to the Permission from the big box on the left to the big box on the right. Note that all of the configuration options available are not covered in this wiki. Only the configuration options that are required or most common are covered in this wiki.
• When done configuring the Permission, click the green button labeled Save & Finish on the bottom right-hand corner.

 

Groups

Groups are just groups of Users. Groups are useful for grouping Users together according to their roles and responsibilities, where each User needs to have the same Permissions. This means that Permissions can be configured at the Group level rather than individually for each User. Below are the instructions for setting up a Group.

• Click on Admin on the far left menu to open all of the administrative settings.
• From the menu of administrative settings, click on Groups under the Security section.
• From the Groups Management page, click on the New button located in the top right-hand corner.
• From the Add New Group page, configure the following:
  • Group Name (required)
  • Description (optional)
  • Check "Automatically Join New Users to this Group" (optional)
  • Check "Admin Privileges" (optional)
  • Move any/all Users that you want in this group from the big box on the left to the big box on the right.
• Once you are done configuring the Group, click the green button labeled Save on the bottom right-hand corner.