Deploy a Private BaoTa Panel Cloud with btcloud on Your Own Server

Overview

The BaoTa Panel is a widely used open‑source server management tool, but its official version relies on cloud services that may expose data. Teams that require full control can deploy the third‑party btcloud project to run a private cloud that mimics the official API while keeping all data on‑premises.

Third‑Party Cloud Solution

btcloud

is an open‑source PHP project hosted on GitHub (maintained by flucont ) under the MIT license. It provides a self‑hosted cloud backend compatible with BaoTa, enabling plugin synchronization, version distribution, and panel customization without external reporting.

Core Features and PHP Highlights

Plugin Management and Updates : Syncs plugin lists from the official BaoTa API and downloads incremental update packages using PHP scripts.

Panel Version Distribution : Supplies modified Linux, Windows, and aaPanel packages without encrypted files, downloadable via the cloud API.

Security and Management Tools : Includes IP whitelist/blacklist, operation logs, usage records, and scheduled tasks stored in MySQL.

Custom Optimizations : Removes ads, telemetry, and unnecessary tasks, reducing resource consumption.

No Architecture Limits : Works on any server architecture (x86, ARM, etc.) because it is fully open source.

From a PHP perspective, btcloud uses the ThinkPHP MVC framework, Composer for dependency management, and SQL scripts for database initialization.

How to Deploy

Environment Preparation

Server Requirements : Linux (CentOS 7+ or Ubuntu 18+), at least 2 GB RAM, 50 GB storage.

Software Dependencies : PHP 7.4+ , MySQL 5.6+, and the fileinfo and ZipArchive extensions.

Other Tools : Composer for PHP package installation.

Installation Steps

Download Project : Get the latest release from the GitHub Release page (v3.5, released 2025‑12‑16) or clone the repository. git clone https://github.com/flucont/btcloud.git

Install Dependencies : Inside the project directory run composer install --no-dev to fetch ThinkPHP and other required packages.

Configure Web Server : Point the document root to the public folder and set up Nginx or Apache rewrite rules for ThinkPHP.

Database Initialization : Access the site root; the installer will prompt for MySQL credentials and create tables using the provided install.sql script.

First‑time Configuration : Log into the backend and replace the default URL (e.g., http://www.example.com) with your domain using the “Batch Replace Tool”.

Sync Plugins : In “System Basic Settings”, temporarily configure the official BaoTa API to pull plugin lists and updates, then schedule regular syncs.

Panel Integration : Change the API URL in your BaoTa panel’s system settings to point to the btcloud domain and install the companion plugin to fetch resources from the private cloud.

Common Issues and Optimizations

If plugin sync fails, verify that required PHP extensions are enabled and that the server can reach the official BaoTa endpoints.

When updating btcloud, replace all files from the new release except the data directory, then adjust version settings manually.

Enable HTTPS and restrict backend access by IP to improve security.

Test in a virtual machine before deploying to production servers.

Benefits and Use Cases of Private Deployment

Running btcloud as a private cloud enhances data security and offers flexibility: enterprises can host all panel services internally, avoiding data leakage; developers can add custom features such as integration with internal monitoring systems. This approach satisfies strict compliance requirements (e.g., GDPR) for regulated industries like finance and healthcare.

Because btcloud is lightweight, it reduces server load, making it suitable for small‑to‑medium teams that need to manage dozens of servers without relying on the official Pro version.