FlashPanel

Appearance

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.

Note

Each website can only have one source code installed. If you have already uploaded files to the website directory yourself, installing source code will overwrite them. Back up your files before installing.

Accessing Source Code Installation ​

  1. Open your site's management page
  2. Click Install Source Code in the left-hand menu

You will see the installation options available for your website. This menu only appears while the site has no source code installed.

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 (Custom, Laravel or WordPress).

How it works:

  1. First, upload your source code to the website directory via SFTP/SSH
  2. Open the site's Install Source Code menu
  3. Select the Self Upload option
  4. In the Update Site Type dialog, choose your project type from the dropdown:
    • Custom - For generic/custom applications or static HTML sites
    • Laravel - If you uploaded a Laravel application
    • WordPress - If you uploaded a WordPress site
  5. Click Update

What happens:

  • FlashPanel will mark your site as having source code installed
  • The Install Source Code menu will be hidden (since the code is already there)
  • Features specific to the selected type are enabled (e.g., choosing WordPress shows the WordPress management page)
  • 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 it is a WordPress site and show the WordPress management tools for it.

Git Repository ​

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

! SSH Key Required

The server needs read access to the Git repository. You can add the server's SSH key to your Git provider, or use a site-specific deploy key (see step 4).

Steps to install from Git:

  1. Select the Git option
  2. Enter the repository SSH URL in the Repository field (e.g., [email protected]:user/project.git)
  3. Enter the branch name in the Branch field (e.g., main or master)
  4. If you haven't added the server's SSH key to your Git provider, check Automatically add deployment key (Recommended). The deploy key is shown below; add it to the repository on your Git provider before continuing
  5. 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. If you have connected several GitHub accounts, choose one in the Git account field
  3. Select an Organization (or Personal for your personal account). If an organization is missing, click Grant permission to give the app access to it
  4. Select the repository in the Repository field (click Load to reload the list)
  5. Select the branch in the Branch field (click Load to reload the list)
  6. Check Automatically add deployment key (Recommended)
  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 the GitHub installation (without the organization step), selecting the GitLab option and clicking Install GitLab Repository.

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 the warning Bitbucket access token expired!. Reconnect your Bitbucket account to refresh the token.

Follow the same steps as the GitHub installation (without the organization step), selecting the Bitbucket option and clicking Install Bitbucket Repository.

WordPress ​

Quickly install the latest version of WordPress on your website.

Steps to install WordPress:

  1. Select the WordPress option
  2. Choose the version in the WordPress Version field
  3. Enter the site title in the Site Title field
  4. Enter an admin username in the Username field
  5. Enter an admin password in the Password field (or click the key icon to generate a random password)
  6. Enter your email address in the Your Email field
  7. (Optional) Set a custom Table Prefix (defaults to wp_). This is useful for running multiple WordPress installations on a single database or for improving security
  8. (Optional) Check Discourage search engines from indexing this site
  9. (Optional) Select a database user and database (leave blank to auto-create)
  10. (Optional) Enter commands in the Install Custom Script editor to run after installation (prefix WordPress CLI commands with $WPCLI)
  11. Click Install WordPress

Once installation completes, WordPress is ready to use. Visit https://your-domain/wp-admin and log in with the admin account you entered, or use the one-click login button on the WordPress page.

phpMyAdmin ​

Install phpMyAdmin to manage your databases through a web interface.

Steps to install phpMyAdmin:

  1. Select the phpMyAdmin option
  2. Check the Yes, Do it! confirmation box
  3. 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. Enter a Port for the app (or keep the default) and check the Yes, Do it! confirmation box
  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. Check the Yes, Do it! confirmation box
  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. Enter a Port for the app (or keep the default) and check the Yes, Do it! confirmation box
  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. Enter a Port for the app (or keep the default) and check the Yes, Do it! confirmation box
  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 option
  2. Enter the IMAP Host and SMTP Host, and choose a database type
  3. Click Install Roundcube Webmail

For detailed information, see the Roundcube documentation.

After Installation ​

Once you have installed your source code, you can:

Changing Site Type ​

After you install source code, the site type is set based on how it was installed (e.g., Git, WordPress, phpMyAdmin...). For Custom, Laravel or WordPress sites, you can switch between these three types from Settings > Update Site Type. See Site settings.

Site types:

  • Custom - Generic/custom application
  • Laravel - Laravel PHP framework
  • WordPress - WordPress CMS
  • Git - Installed from a Git repository (cannot be changed manually)
  • 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)
  • n8n - Workflow automation tool (cannot be changed manually)
  • Roundcube - Webmail (cannot be changed manually)