Source Code Installation

Once your website has been created in FlashPanel, you can install source code and applications to it. This page shows all available source code installation options.

! Important Note

Note that each website can only be installed with one source code. If you install the source code on top of the source code uploaded manually, it will be overwritten. Please make sure you have backed up your files before installing the source code.

Accessing Source Code Installation

1. Navigate to your site management console
2. Click on the Source Code menu in the sidebar

You will see various installation options available for your website.

Installation Options

Self Upload

The Self Upload option is used when you have already manually uploaded your source code to the server via SFTP, SSH, or any file transfer method, and want to declare this to FlashPanel.

Purpose: This feature allows you to inform FlashPanel that you have manually uploaded your source code and specify what type of application it is (WordPress, Laravel, or Any).

How it works:

1. First, upload your source code to the website directory via SFTP/SSH
2. Navigate to the Source Code section in your site management console
3. Select the Self Upload option
4. Choose your project type from the dropdown:
   • Any - For generic/custom applications or static HTML sites
   • Laravel - If you uploaded a Laravel application
   • WordPress - If you uploaded a WordPress site
   • Other types as available
5. Click Update

What happens:

• FlashPanel will mark your site as having source code installed
• The Source Code Settings section will be hidden from the interface (since the code is already there)
• FlashPanel will configure Nginx/Apache settings appropriately based on your selected project type
• No automatic deployment or Git integration will be configured

Example use case: You have a WordPress site that you downloaded and customized on your local machine. You upload all the files via SFTP to your server, then use Self Upload with project type WordPress to let FlashPanel know what type of site it is, so the system can optimize server configurations accordingly.

Git Repository

You can install source code from a plain Git repository without using GitHub, GitLab, or Bitbucket integration.

! SSH Key Required

Before installing from a Git repository, you need to add the FlashPanel SSH key to your Git provider manually.

Steps to install from Git:

1. Select the Git option
2. Enter the repository SSH URL (e.g., [email protected]:user/project.git)
3. Enter the branch name (e.g., main or master)
4. Choose whether to Automatically add deployment key (Recommended) if you haven't registered a server global key
5. Optionally enable Automatically install Composer dependencies to run composer install after pulling code
6. Click Install Git Repository

GitHub

Install source code directly from your GitHub repositories with full integration support.

! GitHub Connection Required

Before installing from GitHub, you must first connect your GitHub account with FlashPanel.

Steps to install from GitHub:

1. Select the GitHub option
2. Select an organization (or personal account)
3. Load and select your repository from the dropdown
4. Load and select the branch you want to deploy
5. Choose whether to Automatically add deployment key (Recommended)
6. Optionally enable Automatically install Composer dependencies
7. Click Install GitHub Repository

The system will automatically load your organizations, repositories, and branches for easy selection.

GitLab

Install source code from your GitLab repositories with the same features as GitHub integration.

! GitLab Connection Required

Before installing from GitLab, you must first connect your GitLab account with FlashPanel.

Follow the same steps as GitHub installation, selecting the GitLab option instead.

Bitbucket

Install source code from your Bitbucket repositories.

! Bitbucket Connection Required

Before installing from Bitbucket, you must first connect your Bitbucket account with FlashPanel.

! Token Expiration

If your Bitbucket access token has expired, you will see a warning message. Simply reconnect your Bitbucket account to refresh the token.

Follow the same steps as GitHub installation, selecting the Bitbucket option instead.

WordPress

Quickly install the latest version of WordPress on your website.

Steps to install WordPress:

1. Select the WordPress option
2. Choose the WordPress version from the dropdown
3. Enter the site title
4. Enter an admin username
5. Enter an admin password (or click the key icon to generate a random password)
6. Enter your email address
7. Optionally check Discourage search engines from indexing this site
8. Optionally select a database user and database (leave blank to auto-create)
9. Optionally add custom installation scripts (use $WPCLI before WordPress CLI commands)
10. Click Install WordPress

After installation completes, visit your website domain to complete the WordPress setup from your browser.

! WordPress Security

You should proceed with WordPress installation immediately after FlashPanel has installed it, so that it is secured with your username and password. You can also create a new Security Rule before installing WordPress so that your installation is password protected.

phpMyAdmin

Install phpMyAdmin to manage your databases through a web interface.

Steps to install phpMyAdmin:

1. Select the phpMyAdmin option
2. Click Install phpMyAdmin

Once installed, you can access phpMyAdmin through your website domain and log in using any of your database usernames and passwords.

Uptime Kuma

Install Uptime Kuma, a self-hosted monitoring tool for your websites and services.

Steps to install Uptime Kuma:

1. Select the Uptime Kuma option
2. Configure the installation settings
3. Click Install Uptime Kuma

For detailed instructions, see the Uptime Kuma tutorial.

ImunifyAV

Install ImunifyAV, a powerful antivirus and security scanner for your website.

Steps to install ImunifyAV:

1. Select the ImunifyAV option
2. Configure the installation settings
3. Click Install ImunifyAV

For detailed instructions, see the ImunifyAV tutorial.

Chatwoot

Install Chatwoot, an open-source customer engagement platform.

Steps to install Chatwoot:

1. Select the Chatwoot option
2. Configure the installation settings
3. Click Install Chatwoot

For detailed instructions, see the Chatwoot tutorial.

n8n

Install n8n, a workflow automation tool that connects your apps and services.

Steps to install n8n:

1. Select the n8n option
2. Configure the installation settings
3. Click Install n8n

For detailed information, see the n8n documentation.

Roundcube Webmail

Install Roundcube, a browser-based IMAP client with an application-like user interface.

Steps to install Roundcube:

1. Select the Roundcube Webmail option
2. Configure the installation settings
3. Click Install Roundcube

For detailed information, see the Roundcube documentation.

After Installation

Once you have installed your source code, you can:

• Configure deployments to automatically pull updates from your repository
• Set up SSL certificates for secure HTTPS access
• Configure Nginx settings for your website
• Set up environment variables for your application

Changing Site Type

After installing certain applications (like WordPress or Laravel), FlashPanel will automatically detect and set your site type. You can also manually update your site type by selecting Self Upload and choosing the appropriate project type from the dropdown.

Available site types:

• Any - Generic/custom application
• Laravel - Laravel PHP framework
• WordPress - WordPress CMS
• phpMyAdmin - Database management (cannot be changed manually)
• Chatwoot - Customer engagement platform (cannot be changed manually)
• Uptime Kuma - Monitoring tool (cannot be changed manually)
• ImunifyAV - Antivirus scanner (cannot be changed manually)