# App installer

URL: https://docs.vaultpanel.net/guides/websites/cms-installer

> Install WordPress, Joomla, Drupal or Laravel in a PHP website in one step, with its database and admin account, from the official release checked on download.

The app installer puts WordPress, Joomla, Drupal or Laravel in a PHP website in one step. VaultPanel creates the app's database and user, downloads the app from its own project, checks it, and runs its installer. Open it from **Web > App Installer**, or from the **Apps** tab of a PHP website.

## Supported apps

| App | Needs PHP | Installed | Source |
| --- | --- | --- | --- |
| **WordPress** | 7.4 or newer | In the document root, or a folder of it | wordpress.org, checked against its published SHA-1 |
| **Joomla** | 8.1 or newer | In the document root, or a folder of it | The Joomla project's GitHub releases, checked against their SHA-256 |
| **Drupal** | 8.1 or newer | As a project folder; the site serves its `web/` folder | `drupal/recommended-project` through Composer, with Drush |
| **Laravel** | 8.2 or newer | As a project folder; the site serves its `public/` folder | `laravel/laravel` through Composer |

Drupal and Laravel are projects: their code and settings (`.env`, `vendor/`) sit in a folder at the top of the site, and the website's document root becomes the project's public folder, so they are never served.

## Install an app

### Open the installer

Go to **Web > App Installer**, or open a PHP website's **Apps** tab, and click **Install an app**.

### Choose the app and where it goes

Pick the app, then **An existing PHP website** or **A new website**. For a new website, choose the **Server**, the **Domain**, the **Site name** and the **PHP version**, as when you [create a website](https://docs.vaultpanel.net/guides/websites#create-a-website).

### Fill in the details

| Field | Notes |
| --- | --- |
| **Folder** (WordPress, Joomla) | Optional. `blog` installs the app at `example.com/blog`. The folder must be empty. Leave it empty to install at the site's address. |
| **Project folder** (Drupal, Laravel) | Required; `drupal` or `laravel` by default. Made at the top of the site. |
| **Site title** | The site's name in the app. |
| **Admin username** | 3 to 60 letters, digits, dots, dashes and underscores. |
| **Admin email** | Optional. |
| **Admin password** | Optional: 12 to 128 characters without spaces. Leave it empty for a strong generated one. |

Laravel has no admin account, so it asks only for its folder.

### Install

The install takes a minute or two. VaultPanel shows the app's address and, for apps with an admin, its admin page, username and password.

> **Important:**
The admin password is shown once. Save it before you close the window: VaultPanel does not keep it.

## What the installer does

1. **The website**: a new PHP website when you chose one, created the usual way.
2. **The database**: a database and a user with all privileges on it, on the server's database server, named after the site and the app. It is linked to the website, so the website's [backups](https://docs.vaultpanel.net/guides/backups-and-automation/backups) can include it. It also shows on the [Databases](https://docs.vaultpanel.net/guides/databases) page.
3. **The app**: the agent installs any PHP extensions the app needs (and Composer for Drupal and Laravel), downloads the app, checks it, puts it in the site and runs its installer. Everything runs as the website's own Linux user, and passwords reach the installers through their environment, never their command line.
4. **The document root**: for Drupal and Laravel, the website's document root is pointed at the project's public folder.

The installed app shows on the list with its status: waiting, installing, installed, removing or failed. A failed install removes what it put in the site.

## Requirements and limits

- The website must be a PHP website running a PHP version the app supports. Switch the version on the website's **Overview** first, or install a newer one: see [PHP versions](https://docs.vaultpanel.net/guides/websites/php-versions).
- A website that serves an app from **Applications**, or the panel itself, cannot take an installed app.
- Drupal and Laravel take over the website's document root, so a website can hold only one of them, and not next to another installed app.
- Two apps cannot share a folder.
- The project folder cannot be `tmp`, `logs`, `releases`, `shared` or `current`.
- The server's agent must be 0.20.0 or newer.

For hosting customers, the website (when a new one is made), the database and the database user count against their plan, and the install is refused before anything is made when the plan has no room.

## Remove an app

Click the remove button next to the app on the list. Its files are deleted from the website; the website itself stays.

- **Also delete its database** deletes the app's database and its user too. Take a [backup](https://docs.vaultpanel.net/guides/backups-and-automation/backups) first if you need the content.
- For Drupal and Laravel, the website's document root goes back to what it was before the install.
