Creating a Project

The New Project option creates a new project. When you create a new project, Ghidra will close your current project, create the new project, and update the Ghidra Project Window with the newly created project. The New Project wizard takes you through the steps to create either a non-shared project or a shared project. The shared project can be shared with others, meaning that the project will be associated with a repository on a server that other users can access.


To create a new non-shared project:

  1. Select the FileNew Project... menu option from the Ghidra Project Window.
  2. The first panel of the New Project wizard is displayed, where you choose the project type.

  1. Leave the Non-Shared Project radio button selected to create a project that will not be shared with others.
  2. Activate the Next>> button.

  1. Click on the browse button (...) to display a file chooser; select the directory of where you want your new project to reside. The Project Directory field defaults to the last directory that you specified to create a new project.
  2. Enter the name of your new project; the Finish button is enabled.
  3. Activate the Finish button.  If you have a project opened, Ghidra closes the project and opens the new project. 
  4. If there is an active project and it has been modified, Ghidra will prompt to save the active project before closing it. From the Save Modified Files dialog, click the OK button to save changes to the project that is being closed as the new one is opened.


Creating a Shared Project

The discussion for this section assumes the following:

To create a shared project, 

  1. Select the FileNew Project... menu option from the Ghidra Project Window; the first panel of the New Project wizard is displayed.
  2. Select the Shared Project radio button on the Select Project Type panel.

  1. Activate the Next >> button.

  1. Enter the name of the server or the IP address of the server of where the repository resides. (If you had specified server information for accessing another shared project, then the server and port number from that project are used as default values.)
  2. Enter the port number.  The default port number is 13100.
  3. Activate the Next >> button. 

Refer to the Troubleshooting page if you fail to connect to the Ghidra Server.


  1. In this example, three repositories are listed in the Repository Names list which reflect all the repositories the user has access to on the currently connected server. This list may differ based upon your login credentials. By default, the Existing Repository radio button is selected because of the existing repositories found on the server. Only those repositories you have been granted access to will be included in this list.
  2. Activate the Next>> button. If you selected the Create Repository radio button, then the following sample Project Access panel to specify user access is displayed. If you are creating a new shared repository, you are by default the Administrator in the project. You are not allowed to change your own access. If the server has been configured with anonymous mode enabled, an additional checkbox control will appear allowing you to grant anonymous access to this new repository.


  1. Users that are known to the server are listed in the Known Users area. Users that are part of the project are marked with the icon. To add users, select users from Known Users, select the Add>> button. Add all users by selecting the Add All button. To remove users, select users in the project, and select the <<Remove button. To remove all users (except yourself), select the Remove All button. 

    The Project Users table on the right side of the dialog indicates user privileges:

    If you are creating a project against an existing repository, then you will not see the Project Access panel as part of the New Project wizard.  After you have opened the shared project, and if you are an administrator in the existing repository, then you can display and modify user privileges by choosing the ProjectEdit Project Access List... option


  2. Active the Next>> button; you must next specify where to create your project that will be associated with the project repository. Typically, you would specify a directory on your local file system.

  1. Select the project directory. The Project Directory field defaults to the directory that you last specified for a new project.  Click on the browse (...) button to bring up a file chooser.
  2. The Project Name field defaults to the name of the repository that you selected in Step 7. The Finish button is enabled when the  Project Directory and Project Name fields have valid entries. 
  3. Select the Finish button to complete the New Project process. 

Before the new project is opened, if you made changes, you are asked whether to save the old project. If you choose to open the new project, the default tool Code Browser is in the Tool Chest and no files are associated with the project that you have just created. Your current workspace is named "Workspace."


Related Topics: