The New Project wizard guides you through 5 steps. Click New Project in the sidebar to start. The steps appear in the Stepper at the top of the screen.
Step 1 — Repository
- Select a Git provider (among your connected accounts).
- Pick the repository from the list (search available).
- Select the branch to deploy.
- Paylood analyzes the repository and detects your stack: framework, database, listening port.
- If the repository is a monorepo, choose the service (path) to deploy.
Capture à venir
en/projects-create
Cette capture illustrera la vue correspondante. Elle est générée automatiquement par le pipeline Playwright.
Tip
The analysis runs automatically once a branch is selected. If it fails (e.g. very large repository), retry the analysis with the provided button before continuing.
Step 2 — SSH Config (server)
- Choose Connect an existing server or Create a new server.
- Enter the credentials: IP, SSH port, user and authentication (password or private key).
- Click Test connection: the SSH steps stream live.
- Confirm to link the server to the project.
On first connect, Paylood installs Docker and sets up swap if needed. It is transparent for you.
Step 3 — Database & Services
This step lists the detected services:
- Database (PostgreSQL, MySQL, MongoDB\u2026)
- Caches (Redis, Memcached\u2026)
- Storage (MinIO\u2026)
- Your application (Node.js, PHP\u2026)
For each service you can:
- Enable or disable it with the toggle.
- Change the version, port, entry path and volumes.
- Add custom services via a Docker Hub search.
- Configure global environment variables, or import them from a
.envfile.
Tip
The Build artifacts option is useful for frontend apps: the generated build (e.g. dist folder) is served directly. For frontend + backend stacks without a domain, Paylood merges both into a single Dockerfile.
Step 4 — Domain
- Choose the domain mode:
- Free subdomain
*.paylood.app(immediate, managed by Paylood). - Your custom domain (e.g.
api.mysite.com). - Root domain (e.g.
mysite.com).
- Free subdomain
- If you pick a custom domain, Paylood shows the A DNS record to create.
- Click Verify DNS to check propagation.
- Choose SSL: automatic (Let’s Encrypt), custom (certificate + key) or none.
Capture à venir
en/domains-overview
Cette capture illustrera la vue correspondante. Elle est générée automatiquement par le pipeline Playwright.
Step 5 — Review
- Check the summary: repository, branch, server, services, variables.
- Click Save & Deploy to save and immediately run the first deployment.
- Or click Save to save without deploying.
After creation
- The project appears on the Projects page.
- The first deployment runs in the Logs tab (see Deployments).
- You can open the project page to manage variables, backups and console.
Warning
An incomplete project (unfinished steps) cannot be deployed. The application redirects you automatically to the missing wizard step.
Deleting a project
From the Projects page, open the project menu then Delete. Deletion is permanent (project, environment, deployments). Containers on your server are stopped on the next cleanup.