If you’re brand new to Pierre, this crash course helps you set up a new workspace on Pierre, from signing up after you receive an invite to creating and pushing your first project.
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.
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.
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.
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.
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.
Heck yeah, you’ve setup your new workspace on Pierre and have your local environment ready to go! When you’re ready, consider looking over our guides to familiarize yourself with Pierre.
Code hosting, review, docs, and CI. One place for product engineers and their teams to focus on what they do best—building products.
Join the WaitlistSkip the line! Join our Discord for early access