Skip to content

🛠️ BT Panel Docker Installation Guide

This document provides a step-by-step tutorial with screenshots for deploying New API using BT Panel's Docker functionality.

📋 Prerequisites

  • BT Panel version 9.2.0 or higher installed
  • Recommended systems: CentOS 7+, Ubuntu 18.04+, Debian 10+
  • Server configuration: At least 1 core, 2GB RAM

🔧 Installing BT Panel

  1. Visit the BT Panel official website to download the installation script suitable for your system
  2. Run the installation script to install BT Panel
  3. After installation, use the provided address, username, and password to log into BT Panel

🐳 Installing Docker

  1. After logging into BT Panel, find and click Docker in the left menu bar
  2. On first entry, you'll be prompted to install Docker service, click Install Now
  3. Follow the prompts to complete the Docker service installation

🚀 Installing New API

  1. In BT Panel's Docker functionality, click App Store
  2. Search for and find New-API
  3. Click Install
  4. Configure the following basic options:
  5. Container name: Customizable, default is new-api
  6. Port mapping: Default is 3000:3000
  7. Environment variables: Add as needed (e.g., TZ=Asia/Shanghai, etc.)
  8. Directory mapping: Ensure the /data directory is mapped to a host directory
  9. Click Submit to complete installation

🔄 Method 2: Using Custom Image

  1. In BT Panel's Docker functionality, click Image Management
  2. Click Get Image -> Pull Image
  3. Enter image name: calciumion/new-api:latest
  4. Click Submit and wait for the image to be pulled
  5. After pulling is complete, go to Container List and click Create Container
  6. Fill in the following information:
  7. Container name: new-api (customizable)
  8. Image: Select the recently pulled calciumion/new-api:latest
  9. Port mapping: Add 3000:3000
  10. Directory mapping: Add /your/host/path:/data (replace with your host path)
  11. Environment variables: Add as needed (e.g., TZ=Asia/Shanghai, etc.)
  12. Click Submit to complete installation

⚙️ Configuration and Access

After installation, you can access New API at the following address:

http://server-IP:3000

Default admin username: root
Default admin password: 123456

Important

It is recommended to change the default password immediately after first login.

❓ Common Issues

1. Cannot Access New API Interface

  • Check if port mapping is correct
  • Confirm that port 3000 is allowed in server firewall
  • Check if the container is running normally

2. Data Cannot Be Persisted

  • Confirm that the /data directory is correctly mapped
  • Check if the host directory permissions are correct