# Installation

To install Chevereto it requires a server environment where the software and uploaded files will be served.

Requirements

Always check that the server provides the requirements required to run Chevereto.

# Docker

Create the chv-network that containers will use to comunicate each other.

docker network create chv-network

# Database container

Create the chv-mariadb container connected to chv-network.

docker run -it \
    --name chv-mariadb \
    --network chv-network \
    --network-alias mariadb \
    --health-cmd='mysqladmin ping --silent' \
    -e MYSQL_ROOT_PASSWORD=password \
    mariadb:focal

Create the chevereto database and its user. Note that MySQL could take a while to start mysqld.

docker exec chv-mariadb mysql -uroot -ppassword -e "CREATE DATABASE chevereto; \
    CREATE USER 'chevereto' IDENTIFIED BY 'user_database_password'; \
    GRANT ALL ON chevereto.* TO 'chevereto' IDENTIFIED BY 'user_database_password';"

# Chevereto container

A Chevereto container can be either bootstrapped or you can build and manage your system images using container registry (recommended).

# Root installation

# Prepare Database

Run the following to create the chevereto database and its user binding:

sudo mysql -uroot -ppassword -e "CREATE DATABASE chevereto; \
    CREATE USER 'chevereto' IDENTIFIED BY 'user_database_password'; \
    GRANT ALL ON chevereto.* TO 'chevereto' IDENTIFIED BY 'user_database_password';"

# Installer

The chevereto/installer (opens new window) is a single .php file which will download and extract the latest release in the target destination.

Upload the installer (opens new window) to your server target destination (usually the public_html folder).

Using CLI (recommended):

Download the software at the installer path.

php installer.php -a download -s chevereto -l=licenseKeyHere

Extract the software indicating target -p path to extract.

php installer.php -a extract -s chevereto -p /var/www/html -f chevereto-pkg-*.zip

Once done, remove the installer.php file and open your website at /install to complete the process.

Using HTTP:

Open your website at /installer.php and follow the process.

Chevereto Installer

WARNING

The installer HTTP API will POST to /install to complete Chevereto installation. If that process fail, you must remove the installer.php file and open your website at /install to complete the process manually.

# Zip package

Download the latest release (opens new window)
Upload all the contents of the chevereto folder to your server (usually in the public_html folder)
Go to your target website URL and follow the instructions

← Deploy Post-Install →