Create Projects

Use Projects to set up completely separate environments within your JFrog Connect account. This page describes how to create, configure, and delete 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.

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.

Configure Project

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

  • Communication Cycle: The default value is 15 seconds. To change the cycle time, click edit and enter a different cycle.

  • 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.

Add User to a New Project

When you create a new project, you are the only user defined for the project. To add users, do the following:

  1. In Settings, go to the User Management tab and click the Edit pencil for a user in the list.

  1. Mark the General Permissions that the user should have.

  2. Under Project Permissions, click Grant Access for Other Projects.

  1. In the dropdown list, choose the new project that you just created and click Grant Access. You can then mark the specific permissions the user should have to the new project and save.

Register Device to Different Project

It is not possible to move a device from one project to another. If you want a device to belong to a different project, you must run the registration procedure for the device (see Connect a Device) using the new project name for the <Project> parameter in the registration command.

sudo wget -O - "" | sudo sh -s <UserToken> <Project>

Delete a Project

When you delete a project, you also delete all devices that were registered to that project. A device can be registered to only one project.

To delete a project, do the following:

  1. Choose a project in the project filter.

  1. Go to Settings and choose the Project tab. Click Delete Project and confirm the deletion.

What’s Next?

Last updated