One of the core tenets of Metavus is the importance of getting you up and running as quickly and easily as possible.


The current version of Metavus is 1.0.0.



Installation of Metavus usually takes less than five minutes.


Metavus is designed to run on a web server with a LAMP (Linux/Apache/MySQL/PHP) stack.

The minimum required PHP version is 7.1.  The minimum required MySQL version is 5.0.  (MariaDB may also be used, in place of MySQL.)  (PHP 7.1 was released in 2016, so most servers put online in the last five years or that are older but actively-maintained should work fine.)


  1. Download the Metavus distribution package from the link above.
  2. Create a new database for Metavus on your web server, and a MySQL (or MariaDB) user who has all privileges for accessing and modifying it.
  3. Unzip the Metavus package and upload the files to the desired location on your web server.
  4. Access your new Metavus installation using a web browser (go to, for example, “” or “”, depending on your domain and which directory you uploaded the files to), and follow the instructions on that page to complete the installation.


  • The database for a new installation of Metavus should be empty when starting the installation.
  • If you want Metavus to live in the root of your domain (e.g. “”), upload the files to the root directory of your web server.
  • If you want Metavus to live in its own subdirectory under your domain (e.g. “”), then create an appropriately-named directory on your server (like “collection”), and upload the files to that directory.
  • The URL for your site should match where you uploaded your files.  So if you uploaded them to the root directory, you would go to “”, while if you uploaded them to a subdirectory called “collection”, you should visit “”.


Like the installation, upgrading Metavus to the latest version is designed to be quick and easy.

To upgrade to a new version of Metavus, just download the Metavus package, unzip the package and upload the files to your site, and then visit your site with your browser.  The upgrade will be run automatically.

The files unique to your site are all stored in the “local” directory, except for the “.htaccess” file in the base directory;  everything else in the directory tree are Metavus distribution files.

Change Log

Version 1.0.0Released July 19, 2022

Initial release.