Installation

Installation of Appskull is pretty easy. It can be done within few minutes.

Server requirements

  • Apache or Nginx server.
  • PHP version 5.6.x or newer is recommended. If you got PHP 7.x, then go ahead use PHP 7.x latest version. PHP 7.x is much better than PHP 5.6.x versions.
  • OpenSSL PHP extension.
  • MySQL version 5.6 or greater or MariaDB version 10.0 or greater.

Install Appskull

Install Appskull in few steps:

Setup database

  1. Create a new MySQL/MariaDB database. Let's call it appskull. (The database name can be anything you like.)

    You can create a database very easily by using a database management application. For example, phpMyAdmin, Adminer, Sequel Pro. In this case we are using phpMyAdmin.

    Create a database using phpMyAdmin

    You don't have to worry about the database collation option. You can simply leave it alone to whatever it already set to. If you can set this option, then set it to utf8mb4_unicode_520_ci.

  2. Select created database. for example, appskull.

    Select database
  3. Find, select and import database sql file.

    • Where to find database file.

      Database file location
    • Select and import database sql file.

      Select and import database file

Upload Appskull files

Upload the Appskull folders and files to your server. Normally the index.php file will be at your root.

Upload files and folders location

Configurations

  1. Base URL configuration.

    The base URL of the Appskull can be configured in [app_root]/app/config/config.php file. It is URL to Appskull root with a trailing slash. For example, http://example.com/

    Localhost examples:

    • $config['base_url'] = 'http://localhost/appskull/';
    • $config['base_url'] = 'http://localhost/app/';

    Remote host examples:

    • $config['base_url'] = 'http://example.com/';
    • $config['base_url'] = 'http://www.example.com/';
    • $config['base_url'] = 'http://example.com/appskull/';

    Remote host examples with HTTPS:

    • $config['base_url'] = 'https://example.com/';
  2. Database configurations.

    The database configurations can be configured in [app_root]/app/config/database.php file. There are many configuration options available. But you don't have to set all those options. You only have to set few of them.

    Database configurations

Only for Nginx web server

Appskull is fully supports for Nginx web server. However in order to work, it needs small configuration in the Nginx's nginx.conf file.

  1. If Appskull hosted in a root of the host. For example, http://example.com, http://www.example.com, http://localhost. Then use bellow Nginx "location" context directive in your nginx.conf file.

                                    
                                    location / {
                                        try_files $uri $uri/ /index.php?$query_string;
                                    } 
                                    
                                
  2. If Appskull hosted in a sub directory of the host. For example, http://example.com/appskull, http://localhost/appskull. Then you have to use base URL without the host part in the nginx location context directive.

    Examples:

    1. If base URL http://localhost/appskull/, http://example.com/appskull/. Nginx "location" context directive should be:

                                              
                                              location /appskull {
                                                  try_files $uri $uri/ /appskull/index.php?$query_string;
                                              } 
                                              
                                          
    2. If base URL http://localhost/apps/appskull/, http://example.com/apps/appskull/. Nginx "location" context directive should be:

                                              
                                              location /apps/appskull {
                                                  try_files $uri $uri/ /apps/appskull/index.php?$query_string;
                                              } 
                                              
                                          

Example usage of the Nginx "location" context directive in the nginx.conf file.

                        
                        http {

                            server {
                        
                                location / {
                                    try_files $uri $uri/ /index.php?$query_string;
                                }
                        
                            }
                            
                        }
                        
                    

You can get more information on Nginx configuration file (nginx.conf) by visiting this link.

Installation testing

Appskull installation is now complete. You can test the installation by simply accessing Appskull base URL on a web browser. For example, http://localhost/appskull/, http://example.com/

If you have followed all the above installation and configuration steps correctly, then Appskull must load it's user signin/login form like in the bellow image.

Appskull user signin view

Now you can signin/login into Appskull as an administrator by using elonmusk as both username and password and do pretty much anything you want.

Copyright © Nudasoft.