Installation guide

From server to workspace, step by step.

Metis uses a browser-guided installer. Prepare familiar PHP infrastructure, open the site, and let the installer verify the environment before it writes configuration or creates the platform.

Check requirements View install steps
PHP 8.1 or newerDatabase MariaDB or MySQLWeb server Apache, Nginx, or LiteSpeedMemory 2 GB minimum
01
Before you begin

Confirm the server is ready.

Metis checks its environment in the browser, but confirming these essentials first makes installation straightforward.

Application runtime

  • PHP 8.1 or newer
  • mysqli, json, mbstring, openssl, pdo, curl, and zip
  • ZipArchive for updates and backups
  • OPcache enabled

Database and web

  • MariaDB or MySQL with InnoDB
  • Apache, Nginx, or LiteSpeed
  • A front-controller fallback to index.php
  • Equivalent protection rules for private paths

Process support

  • proc_open and proc_close
  • proc_get_status and proc_terminate
  • Outbound HTTPS for release checks
  • libsodium or OpenSSL recommended

Writable paths

  • storage/ and runtime cache
  • Public, protected, and private media
  • Private records
  • system/config/
02
Hosting baseline

Give the platform room to work.

2 GBRAM minimum4 GB preferred
2CPU cores minimumMore for busier installations
60 GBStorage minimum100 GB preferred
256 MBPHP memory limit512 MB preferred
03
Install Metis

Let the browser guide the setup.

1

Put Metis on the server

Clone the public repository into the directory that will serve the application.

git clone https://github.com/jvitarius85/metis.git
Alternate method

Download the latest stable release.

The permanent address always delivers the newest public-safe Metis ZIP. Extract it directly into the directory that will serve the application.

curl -fL https://update.hellometis.online/latest -o metis-latest.zip
Download latest release
2

Point the web root to Metis

The Metis root directory contains index.php, the front controller used for application routes.

3

Open the site URL

With no install lock present, Metis opens the installer and begins with system prechecks.

4

Complete the guided installer

  • Review system prechecks
  • Repair writable folders when available
  • Enter and verify database credentials
  • Add basic organization branding
  • Create the first administrator
  • Select optional store modules
  • Begin installation
5

Enter the workspace

Metis creates configuration and tables, enables protections, installs selected modules, writes the install lock, and redirects to /admin/.

04
Apache, Nginx, and LiteSpeed

Route requests. Protect private paths.

The application resolves routes inside its front controller. The server passes non-file, non-directory requests to index.php and denies direct access to private application data.

Apache

The repository .htaccess provides the front-controller fallback and deny rules.

Nginx and other servers

Apply equivalent fallback and protection rules in the server configuration.

Never exposesystem/config/system/src/storage/logs/storage/backups/storage/runtime/
05
After installation

Finish with an operational check.

Log in at /admin/, then confirm the system is prepared for normal operation.

Review SettingsConfigure integrationsConfirm backupsVerify cron healthVerify update healthReview installed modules
Explore official modulesView releases