Skip to main content

Got code?

In order to follow along with this guide, you need a local project. While the guide has been written to accommodate the following stacks, it is not limited to just those listed and are here only as examples.

Trials

When you create your first organization on Upsun, you are also activating your trial for that organization. Get more information on trials.

​
Initialize your Git repository

A Git repository is required for Upsun projects. If you haven’t already done so, initialize a Git repository for your codebase, and commit your files:
Terminal
git init
git add .
git commit -m "Initial commit."
This guide assumes that your repository’s default branch is main. Your Git configuration may result in different default branches (like master), so please run git branch -M main before proceeding.

Don

Whether you’re migrating your own project, or testing Upsun with a starter project, never commit your app’s dependencies. Make sure you ignore directories containing dependencies by updating your .gitignore file.
# JavaScript/Node.js
echo "node_modules" >> .gitignore

# PHP
echo "vendor" >> .gitignore

# Python
echo "env" >> .gitignore

git add .gitignore && git commit -m "Update .gitignore to ignore deps."
Last modified on March 11, 2026