Create a New Workspace

Sign In

Once you’ve been invited by our team to try Pierre’s private alpha, it’s time to sign in to Pierre for the first time and get yourself setup. We recommend signing in with Google, but you can also request a magic link be sent to your email.

Team, or Personal?

After signing up with your invited email address, you’ll be asked to choose between using With a team or for Personal use. Starting with a team allows you to create and customize your first workspace, while personal use automatically creates your first workspace based on your name (e.g., "Mark’s Pierre"). Choose whichever option best fits your needs.

If you choose to start with a team, you’ll be asked to name your first workspace. You can always change this or create more workspaces later.

After that, you’ll be asked to invite teammates. You can also skip this step and invite them later if you’d like. This is the last step in creating your first workspace, and whether you invite folks or skip it, you’ll be taken to your workspace’s home page next.

SSH Keys

After you sign in, you’ll need to setup your SSH keys so you can authenticate and push local changes to Pierre’s server. We recommend using our CLI to set up your SSH keys, but you can also do it manually, too. Use our SSH guides linked below to get setup.

Once you’re done with SSH, continue onto the next step here.

First Repository

In your browser, navigate to your workspace on Pierre. In the left-hand sidebar, click the create a repository link to create your first repository.

After you complete the form and create the repository, you’ll be taken to an empty repository page.

In the right details pane, click the "Copy Git URL" button to copy the Git repository URL. You’ll need this to connect a local project to Pierre.

From your terminal, create a new folder for your project and navigate into it.

# Create project folder
mkdir my-project
cd my-project

# Add an initial file to push up
touch README.md
echo "Hello, Pierre" > README.md

With the project folder and first file made, it’s time to initialize your Git repository and add Pierre as a new remote.

# Initialize a new Git repository
git init

# Add Pierre as a remote (replace {workspace} and {repo-name} with your own)
git remote add origin git@git.pierre.co:/repos/{workspace}/{repo-name}.git

Now you can add and commit your changes before finally pushing the project to Pierre.

# Add changed files
git add .

# Commit changes
git commit -m "Initial commit"

# Push the project to Pierre
git push origin main

Success! Your project is now on Pierre and ready for you to start working on it.

Existing Repositories

If you have any existing Git repositories you’d like to move to Pierre, it’s as straightforward as adding Pierre as a new remote. We recommend making Pierre your new origin and renaming the old one to upstream just in case.

# Rename existing origin to upstream
git remote rename origin upstream

# Add Pierre as new remote origin (replace {workspace} and {repo} with your own)
git remote add origin git@git.pierre.co:/repos/{workspace}/{repo}.git

# Push all branches in the project to Pierre
git push --all origin

And you’re all set! Once pushed, your project and all its branches will be available on Pierre.