# Installation

# Install Using GUI Installer

To install Krayin using our GUI installer, you can follow any of the following methods:

# Method 1:

  • Choose the directory where you want to install Krayin. Open your terminal and navigate to this directory.

  • Once you are in the desired directory, run the following command in your terminal to install Krayin:

    composer create-project krayin/laravel-crm
    
  • Configure your HTTP server to point to the public/ directory of the project.

  • Open your browser and access the following URL:

    http://localhost/krayin/public/
    

    This will launch the Krayin installer.

# Method 2:

Otherwise you can download the zip file and install it using the following steps:

  • Download Krayin (opens new window) from our website.

  • Extract the contents of the downloaded

  • Navigate to the project root directory.

  • Run the following command:

    composer create-project
    
  • Configure your HTTP server to point to the public/ directory of the project.

  • Open your browser and access the following URL:

    http://localhost/krayin/public/
    

    This will launch the Krayin installer.

WARNING

Ensure that Composer is installed on your system

# Install Using Composer

To install Krayin using Composer, use the following steps:

  • Choose the directory where you want to install Krayin. Open your terminal and navigate to this directory.

  • Once you are in the desired directory, run the following command in your terminal to install Krayin:

  • Run the following command:

    composer create-project krayin/laravel-crm
    
  • Run the following command:

    php artisan krayin-crm:install
    

    WARNING

    During the installation process, if the .env file doesn't exist, the installer will prompt you to provide the necessary information.

  • Follow the prompts during the installation process to provide the following details:

    - Please enter the application name : 
    - Please enter the application URL : 
    - Please select the default application locale : 
    - Please select the default currency : 
    - Please select the database connection : 
    - Please select the database host : 
    - Please select the database name : 
    - Please enter your database username : 
    - Please enter your database password : 
    
  • For Create your admin credentials

    - Enter the name of the admin user :
    - Enter the email address of the admin user :
    - Configure the password for the admin user :
    

# Start Using Krayin

# On a Production Server

To access Krayin on a production server, open your domain in a web browser. For example:

https://example.com/

# On Your Local Server

To access Krayin on your local server, follow these steps:

  1. Configure your HTTP server to point to the public/ directory of the project.

  2. Run the following command:

    php artisan serve
    
  3. Open your browser and access the provided local server URL.

# Login as an Admin

To log in as an admin, visit https://example.com/admin/. If you used the php artisan krayin-crm:install command, use the following credentials:

Email: [email protected]
Password: admin123

# Installing Krayin on Shared Hosting

Follow these steps to install Krayin CRM on shared hosting:

# 1. Download Krayin

Go to the official website (opens new window) and download the latest version of Krayin CRM in ZIP format..

# 2. Extract the Contents

Unzip the downloaded file and extract the contents to your local machine.

# 3. Upload Files to Your Hosting Account

Use an FTP client (e.g., FileZilla) or your hosting control panel's File Manager to upload all the extracted files, including hidden files (like .env.example), to the root directory (e.g., public_html) or a subdirectory of your hosting account (e.g., public_html/krayin).

# 4. Set File Permissions

Make the following directories writable by setting appropriate permissions:

- storage/
- bootstrap/cache/

# 5. Set Up a Database

Log in to your hosting control panel, create a new database, and assign a user with full privileges to this database. Note the database name, username, and password for later steps.

# 6. Install Dependencies and Run Installer

  • With SSH Access:

If your hosting account provides terminal or SSH access, navigate to the project root directory and execute the following commands:

composer create-project

php artisan krayin-crm:install

Provide the required details during the prompts, including application name, URL, locale, currency, database connection, and admin credentials.:

Please enter the application name : 
Please enter the application URL : 
Please select the default application locale : 
Please select the default currency : 
Please select the database connection : 
Please select the database host : 
Please select the database name : 
Please enter your database username : 
Please enter your database password : 

Next, create the admin user credentials:

Enter the name of the admin user: 
Enter the email address of the admin user:
Configure the password for the admin user:
  • Without SSH Access:

    1. Run composer install locally on your machine.
    2. Upload the vendor directory to your hosting account via FTP.
    3. Update the .env file with your database and application details.

# 7. Access the Application

Open your browser and visit the application URL (e.g., http://yourdomain.com/).

Now your application will be available in your browser.

# Contributing

Contributions are welcome! Follow the contribution guidelines to get started.

# License

Krayin is open-sourced software licensed under the MIT license.