Websites

App 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.

Last updated

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

AppNeeds PHPInstalledSource
WordPress7.4 or newerIn the document root, or a folder of itwordpress.org, checked against its published SHA-1
Joomla8.1 or newerIn the document root, or a folder of itThe Joomla project's GitHub releases, checked against their SHA-256
Drupal8.1 or newerAs a project folder; the site serves its web/ folderdrupal/recommended-project through Composer, with Drush
Laravel8.2 or newerAs a project folder; the site serves its public/ folderlaravel/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.

Fill in the details

FieldNotes
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 titleThe site's name in the app.
Admin username3 to 60 letters, digits, dots, dashes and underscores.
Admin emailOptional.
Admin passwordOptional: 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.

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 can include it. It also shows on the 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.
  • 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 first if you need the content.
  • For Drupal and Laravel, the website's document root goes back to what it was before the install.