# Getting Started

# What is it?

App Portal is an advanced app/software listing script with rich SEO features where you can create your own App Portal in minutes.

# Changelog

App Portal 2.1.0 Changelog

  • Added: OpenAI Support
  • Added: Amazon S3 Support
  • Added: Wasabi S3 Support
  • Added: Other Apps in the Category
  • Added: Hreflang Support
  • Added: RSS Category Support
  • Added: Categories on Home Page
  • Added: Bulk Delete Support
  • Added: Versions on App Edit Pages
  • Added: Error Pages Customization Support
  • Added: Categories on Home Page
  • Added: Custom Sitemaps
  • Added: Top Bar
  • Added: Package Name Field
  • Improved: Localization System
  • Improved: Slider Design
  • Improved: SEO
  • Deleted: Sitemap Ping Feature [Details]
  • Fixed: Bugs

# Server Requirements

Before installing App Portal, please make sure your server meets the following requirements.

  • PHP 8.0 or 8.1
  • BCMath PHP Extension
  • Ctype PHP Extension
  • JSON PHP Extension
  • Mbstring PHP Extension
  • OpenSSL PHP Extension
  • PDO PHP Extension
  • Tokenizer PHP Extension
  • XML PHP Extension

TIP

You can find many videos and tutorials on various topics in the members area of our site. Click here to access it.

# Installation

TIP

Simplified installation feature has been added with App Portal v2.1.0. If you have previously installed App Portal, we recommend that you review the steps again.

  1. Extract the .zip file downloaded.
  2. Upload all files to your server's home directory.
  3. Create a database and import database.sql
  4. Edit the .env file in the lapp folder in the FTP server and set the variables according to your URL, database and SMTP settings.
APP_URL=http://localhost

...

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=null
DB_USERNAME=null
DB_PASSWORD=null

...

MAIL_DRIVER=smtp
MAIL_HOST=mail.yoursite.com
MAIL_PORT=465
MAIL_USERNAME=null
MAIL_PASSWORD=null
MAIL_ENCRYPTION=null
MAIL_FROM_ADDRESS=null
MAIL_FROM_NAME=null

Example Configuration

APP_URL=http://foxart.co

...

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE="app_portal"
DB_USERNAME="app_user"
DB_PASSWORD="Nc8^@59>1M"

...

MAIL_DRIVER=smtp
MAIL_HOST=mail.foxart.co
MAIL_PORT=465
MAIL_USERNAME="noreply@foxart.co"
MAIL_PASSWORD="oI58+8+2kj"
MAIL_ENCRYPTION=ssl
MAIL_FROM_ADDRESS="noreply@foxart.co"
MAIL_FROM_NAME="Foxart Studios"

TIPS

  • Variables must be written in double quotes. Example: "App Portal" instead of App Portal
  • DB_HOST is usually 127.0.0.1 or localhost, but some servers may use different addresses.
  • MAIL_ENCRYPTION is usually ssl or tls.
  • If the SMTP settings are not valid, you will not be able to reset your password, in which case you will need to reset it with phpMyAdmin or a similar application. If you encounter such a problem, review the FAQ section.
  1. Change Chmod settings of the following folders to 755:

TIP

There is no need to change Chmod settings on most servers. We only recommend changing Chmod settings if you are getting file permission errors.

/lapp/storage/framework

/lapp/storage/logs

/lapp/bootstrap/cache

/images and the folders under it.

/files

/screenshots

  1. That is all, Your site is ready! 🎉

# After Installation

Frontend: https://yoursite.com

Dashboard: https://yoursite.com/admin

Sitemaps: https://yoursite.com/sitemap.xml

The default admin credentials are:

  • Email: admin@site.com
  • Password: admin123456

Important

After the installation, please edit the robots.txt file in the home directory and replace https://yourwebsite.com/sitemap.xml with your own sitemap address

robots.txt

User-agent: *
Disallow:

Sitemap: https://yourwebsite.com/sitemap.xml

TIP

If you want to bulk delete demo apps on your newly created site, please run the link below after logging in to the dashboard:

https://yoursite.com/admin?delete_demo_data

# Security

Change the following two lines in the .env file.

ADMIN_URL="admin"
ADMIN_LOGIN_URL="login"

Example Configuration

ADMIN_URL="admin_vN2gB49vg3"
ADMIN_LOGIN_URL="login_V2G0b3Flv"

After this, your admin panel login address will be as follows.

https://yoursite.com/admin_vN2gB49vg3

After installation, log in to your panel and change your username and password by clicking Account Settings in the left menu.

The .env file contains a lot of sensitive information and should not be accessible with the browser, to test it, open the following address in the browser.

https://www.yoursite.com/lapp/.env

If you can access this file through the browser and view the variables in its content, create a file named .htaccess under the /lapp folder and change its content as follows.

Deny from all

If you can still access the file, please contact your hosting company and request that it be resolved.

# 4. Making the /lapp Folder More Secure (Optional)

To make the lapp folder more secure, please move the /lapp folder to a higher directory and change the line below in the index.php file in the home directory.

$lapp_folder = '/lapp';

with

$lapp_folder = '../lapp';

Tips

  • Please note that not all hosting companies may allow running the /lapp folder in the root directory. Some servers may not support this feature.
  • You can change the name of the /lapp folder if you wish, in this case, be sure to change the name of the /lapp folder by editing index.php

# 5. Changing the APP_KEY (Optional)

The software comes with an APP_KEY, but we recommend that you update it for your security.

To create a new App Key, please visit https://yoursite.com/admin/random_key in your web browser to obtain an App Key and update the APP_KEY in the .env file.

TIP

Please note that you must be logged in to the admin panel to get a new App Key.

Assuming the system generates a new App Key for you as follows:

A58dx1XOI+b55P2psRFoq1ynqMr6N4CNt7j5ytwyQ8o=

Edit the relevant line in the .env file as follows:

APP_KEY=base64:A58dx1XOI+b55P2psRFoq1ynqMr6N4CNt7j5ytwyQ8o=

Note: You need to add the App Key after APP_KEY=base64:

❗️You can see an incorrect usage below.

APP_KEY=A58dx1XOI+b55P2psRFoq1ynqMr6N4CNt7j5ytwyQ8o=