Projects Tab: Add a Website

One project for each website on your server

One project for each website

A project is one website on your server: a folder with your code from Git, a hostname, an Apache virtual host and, if you want, a database that goes into its backups. The Projects tab lists your projects and adds new ones.

Where: Servers › My Servers › your server › Projects tab

01 · Before you start

  • Point the DNS A record of your hostname to the server's IP address. The Add Project dialog shows that address.
  • Want the database in the backups? Create it first on the Database tab.

02 · Add a project

Click + Add Project and fill in:

FieldWhat to put
Project Name *The folder name on the server: letters, numbers, dashes and underscores, for example my-project.
Hostname *The domain of the site, for example project.example.com.
Git Repository URL *The address of your repository, for example git@github.com:user/repo.git.
Git BranchThe branch to check out. Default main.
Git SSH PortOnly if your Git server uses another SSH port than 22.
Project TypeDrupal, Laravel, Generic PHP or WordPress.
Deploy KeyThe SSH private key for a private repository. See Git operations.
Main DatabaseOptional: the database saved with the project's backups.

Click Create Project. A window follows the work line by line.

03 · What happens

  1. Your code is cloned into the project folder.
  2. Opensolr looks at the code to recognise the project type and its web root. See Auto-detection.
  3. The Apache virtual host for your hostname is created, with a temporary self-signed certificate until you install yours with Setup SSL.
  4. The project appears in the list.

04 · The list

Each project shows its name, hostname, type and branch. No VHost means Apache has no virtual host for it yet. Click a project to open its page: see Project details. Help opens these pages.

Projects tab