Install and setup     >     Installation

Manual install

Before manually installing yeager we suggest that you check the requirements first.

Download

First of all you should download the a manual installation package of yeager from http://www.yeager.cm/en/download/. Unzip and upload yeager into the folder where it should run at (e.g. httpdocs/yeager).

Database setup

All yeager packages include a clean database dump for yeager (~db_yeager_clean.sql) which can be found inside yeager's main directory. This SQL file needs to get imported into the database you wish to use.

Configuration and setup

yeager includes a ready-to-use .htaccess file (~.htaccess) for the configuration of the required URL rewriting rules of an Apache webserver. It also includes an example configuration for nginx (~yeager-nginx.conf). 
 
The webserver configuration files (~.htaccess or ~yeager-nginx.conf) and the config file (~config-IPADDRESS.xml.php) use placeholders which a need to get replaced with the corresponding settings or paths in the system environment:

[__DATABASE_SERVER__]  URL of your database server
[__DATABASE_PORT__] Port of your database server
[__DATABASE_USER__] MySQL user
[__DATABASE_PASSWORD__] MySQL user password 
[__DATABASE_NAME__] Name of the database
[__SITE_NAME__]
URL name of the Site the installation should redirect to when called without Site parameter 
[__CFG_WEB_ROOT__] 
  
Path to yeager's webroot directory (/ when installed in the document root or /subfolder/ if you are running yeager from a subdirectory)
[__CFG_FILES_DIR__]  Path to the Files directory (e.g. /frontend/files/)
[__CFG_FRONTEND_DIR__] Path to the Template directory (e.g. /frontend/templates/)
[__CFG_EXTENSIONS_DIR__] Path to the Extension directory (e.g. /frontend/extensions/
[__CFG_PROCESSORS_DIR__] Path to the custom File Processor directory (e.g. /frontend/processors/
[__CFG_SERVER_NAME__] Server/hostname, only required for nginx (e.g. .example.com)
[__CFG_WEB_ROOT_ABSOLUTE__]
  
Server path to yeager's web root directory, only required for nginx (e.g. /var/www/subfolder/)
[__CFG_TMP_DIR__]
  
Path to temporary directory (if replaced with empty string the PHP tmp directory will be used)
 
The ~config-IPADDRESS.xml.php needs to be moved to the yeager/config directory and get renamed to config-IPADRESS.xml.php or config-DOMAIN.xml.php (e.g. config-192.168.1.1.xml.php or config-example.com.xml.php). Further information can be found at Configuration.
 
If you are using an Apache webserver just rename the processed ~.htaccess to .htaccess. nginx users need to load the processed ~yeager-nginx.conf by moving it to the nginx/conf directory and restarting nginx. Unfortunately we do not provide URL rewrite configurations for other webservers than Apache and nginx.

Filesystem permissions

To run properly yeager needs at least permissions to write to the Template, the Files and the Extensions folder. Please make sure that the user your webserver is running as owns sufficient permissions to do so. If that's not the case you should either grant 755 or 777 (depending on your setup) to the respective folders. You can do that either using your FTP client or direct shell access (CHMOD 777). 
 
If you want to make use of the automated update functionality yeager requires also permission to overwrite all files of it's installation. 

Log-in

As soon as the steps described above are completed you can check if yeager is up and running by accessing the URL of the backend interface:

http://www.yourdomain.com/_POSSIBLE_SUBFOLDER_/yeager/ 
 
You will be able to login to yeager using the following account credentials:

Email:      admin@example.com 
Password:     changeme
 
 
Changing yeager's default password should be your first action after installing yeager. Change your account settings by clicking on the blue highlighted username at the top of yeager's main menu.