How to create a New Project in PWSLab?

How to create a New Project in PWSLab?

Create a project

To create a project in PWSLab: In your dashboard, click the green New Project button or use the plus icon in the navigation bar like below. This opens the New Project Page.


On the New project page, choose if you want to:
  1. Create a blank project.
  1. Create a project using with one of the available project templates as per the tech-stack you require.
  1. Import a project from a different repository, if enabled on your PWSLab instance. Contact your PWSLab admin if this option is unavailable.

Blank projects

To create a new blank project on the New project page:
  1. On the Blank project tab, provide the following information:
  1. The name of your project in the Project name field. You can’t use special characters, but you can use spaces, hyphens, underscores or even emoji.
  1. The Project description (optional) field enables you to enter a description for your project’s dashboard, which will help others understand what your project is about. Though it’s not required, it’s a good idea to fill this in.
  1. Changing the Visibility Level modifies the project’s viewing and access rights for users.
  1. Selecting the Initialize repository with a README option creates a README file so that the Git repository is initialized, has a default branch, and can be cloned.
  1. Click Create project.

Project templates

If you are going to work on a Standard technology stack like PHP Laravel, React Native, Gatsby, Ruby on Rails, NodeJS, Android or .NET Core then Project templates can pre-populate your project with necessary files to get you started quickly. 
Project Templates are developed and maintained by PWSLab Team in PWSLab.ORG.
To use a built-in template on the New project page, click on the Create from template tab.

From the list of available built-in templates, click the:
  1. Preview button to look at the template source itself.
  1. Use template button to start creating the project.
Finish creating the project by filling out the project’s details. The process is the same as for using a blank project.

Push to create a new project

When you create a new repo locally, instead of going to PWSLab to manually create a new project and then push the repo, you can directly push it to PWSLab to create the new project, all without leaving your terminal. If you have access to that namespace, we will automatically create a new project under that PWSLab namespace with its visibility set to Private by default (you can later change it in the project’s settings).

This can be done by using either SSH or HTTPS:
  1. ## Git push using SSH
  2. git push --set-upstream git@company.pwslab.net:namespace/nonexistent-project.git master

  3. ## Git push using HTTPS
  4. git push --set-upstream https://company.pwslab.net/namespace/nonexistent-project.git master
Once the push finishes successfully, a remote message will indicate the command to set the remote and the URL to the new project:
  1. remote:
  2. remote: The private project namespace/nonexistent-project was created.
  3. remote:
  4. remote: To configure the remote, run:
  5. remote:   git remote add origin https://company.pwslab.net/namespace/nonexistent-project.git
  6. remote:
  7. remote: To view the project, visit:
  8. remote:   https://company.pwslab.net/namespace/nonexistent-project
  9. remote:
Thus, you have successfully created a brand new project on PWSLab, ready to be accessed. Moving further, use git-commands to clone, commit, pull and push to the repository. 


Have more questions? Please email us at support@peerxp.com
Also, let us know if the article is helpful!

    • Related Articles

    • List of PWSLab CI/CD Environment Variables

      Introduction This document enlists a set of pre-defined environment variables accepted by PWSLab CI/CD for the local environment of the Runner. These can be referenced directly in the .pwslab.yml file or via the Project's Settings > CI/CD > ...
    • How to create and manage External users in PWSLab?

      Introduction In cases where it is desired that a user has access only to some internal or private projects, there is the option of creating External Users in PWSLab. This feature may be useful when for example a Freelancer/Part-time resource is ...
    • PWSLab Git Workshop - Useful commands and concepts

      Agenda A brief history of Git. PWSLab walkthrough. Configure your environment. Workshop. Git Introduction Visit: https://git-scm.com/about Distributed version control. It does not rely on a connection to a central server. Many copies of the complete ...
    • Google OAuth2 OmniAuth Provider for PWSLab Signin/Signup

      To enable the Google OAuth2 OmniAuth provider you must register your application with Google. Google will generate a client ID and secret key for you to use. Enabling Google OAuth In Google’s side: Navigate to the cloud resource manager page ...
    • Billing Policy for PWSLab Accounts

      Introduction PeerXP offers a DevOps as a Service solutions for enterprises - PWSLab. Pricing plans are based on the number of users/projects for different PWSLab products and services.  If your team doesn't fit neatly into one of the Pricing plan ...