Normal installation
The normal installation of Exponential 6 takes two commands: composer create-project gets the code, and exp:install installs the site from the command line, with every answer as an option that has a default. No web server is needed while it runs, and no kickstart.ini has to be written first.
composer create-project se7enxweb/exponential exponential cd exponential php bin/php/console exp:install --apply --random-password --url=http://localhost:8087 php bin/php/console exp:velocity start --engine=php
That installs the sevenx_multisite site package on SQLite with the administrator admin and a generated password, and serves it on http://localhost:8087/ for a first look.
In this section
- Requirements for doing a normal installation: what has to be on the machine first.
- Installing Exponential on a Linux/UNIX based system: the steps, with a database server, Velocity and the cron job.
- Installing Exponential on Windows: what is known to work, and the simpler path through WSL2.
The options of exp:install
| Option | Default | Meaning |
|---|---|---|
| --db= | sqlite | sqlite, mysql (also for MariaDB), pgsql, mongodb or oracle |
| --db-host=, --db-port=, --db-socket= | localhost; 3306, 5432, 27017, 1521 | where the database server is |
| --db-name= | exponential (exponential.db for SQLite) | the database |
| --db-user=, --db-password= | root (mysql), postgres (pgsql) | credentials; or set EXP_INSTALL_DB_PASSWORD, which keeps the password out of the shell history |
| --db-action= | remove | remove (empties the database first), ignore or skip |
| --package= | sevenx_multisite | the site package |
| --language=, --languages= | eng-US | the primary language; more as a comma list |
| --title=, --url= | Exponential, http://localhost | the site name and address; give the real address, it ends up in every link in mails |
| --access= | url | how the siteaccesses site, admin and editor are told apart: url (/site, /admin, /editor), host or port |
| --host=, --admin-host=, --editor-host= | editor: edit.<host without www.> | host names (imply --access=host) |
| --port=, --admin-port=, --editor-port= | 8080, 8081, port + 2 | ports for --access=port |
| --email=, --first-name=, --last-name= | the administrator | |
| --password=, --random-password | a generated password | a given password is kept only with 10 characters or more and when it is not a well-known one |
| --apply, --force | install (the default is a dry run); --force installs over an existing installation | |
| show the configuration that would be used, and stop | ||
| --no-crontab | print the cron lines instead of writing them to the crontab of the installation's owner |
php bin/php/console exp:install --help lists all of them with examples. The summary at the end names the site, admin and editor addresses, the user and the password; the configuration used is kept in var/log/exp-install-<date>.ini with the passwords masked.
--db-action=remove, the default, empties the named database before it installs. Point --db-name at a database that holds nothing you need.
More: The console install and Getting the code in the installation book. The other ways to install: The setup wizard and Automated installation.
In this section
- Requirements for doing a normal installation What a normal installation of Exponential 6 with Composer and exp:install needs on the machine, and how to check it.
- Installing Exponential on a Linux/UNIX based system Installing Exponential 6 on Linux step by step: PHP, Composer, the database, exp:install, permissions, Velocity and the first checks.
- Installing Exponential on Windows Exponential 6 on Windows: WSL2 as the recommended path, and what is known about native Windows with PHP, Apache or IIS.
Contributors
- Balazs Halasy
- Geir Arne Waaler
- Graham Brookins Updated Maintainer
Comments
Add a comment