Create Project

Use Projects to set up completely separate environments within your JFrog Connect account. This page describes how to create and configure a project.

JFrog Connect creates the first project in your Connect account when the account is created. If you need to support multiple Connect environments that have different use cases with different users and permissions defined, you can do this by creating multiple projects in your account. Each project is completely separate and has its own definition properties.

Tip: All input parameters in Connect, such as project name, group, device, access tokens, etc., are case sensitive.

Step 1: Create a Project

To create a project, go to Settings in the left sidebar and do the following:

  1. Go to the Project tab and click Create New Project

  1. Enter the following:

  • Project Name: A name for the project that is alphanumeric and does not contain spaces.

  • Project Key: A unique string that identifies your project. The project key can be used to group together objects that belong to the same project, for example, in the audit log. Starting with a letter, the project key is lowercase alphanumeric and has 2 to 32 characters.

Step 2: Configure the Project

When Connect creates a project, the project has default values. You can change these at any time.

  • Groups: A project is created with two default groups, Test and Production. You can change these or add more groups. For more information about creating, modifying, and deleting groups, see Create Groups.

  • Device Locations: A new project will not have any devices assigned to it. However, when a device registers to the project, its location is set automatically by geolocation using the public IP address of that device. To reset the location using the current IP address, click Refresh Location.

Step 3: Add Users and Devices

To start populating your new project, you need to add some users. You can define Project Permissions which are project specific, so for example, you can create users who can see only this project, and not others. Likewise, you can make your new project invisible to some other users in your account.

To add users, go to the procedure in Add User to New Project.

There are several options for adding devices to the new project:

  • To register a new device to the project, go to: Register a Device

  • If you are ready to register several devices to the project, use one of the procedures in: Register Devices at Scale

  • If you need to move some devices from an existing project to the new one, use one of the procedures in: Change Project

What’s Next?

Learn how to add users to a new project.

Last updated