GeekAI User ManualGeekAI User Manual
  • Guide

    • Introduction
    • Quick Deployment
    • Advanced Deployment
  • Configuration

    • AI Drawing Configuration
    • Music and Video
    • File Storage Configuration
  • Upgrade

    • Smooth Upgrade
  • Development

    • Development and Build
    • How to Skip License Verification
  • Guide

    • Introduction
    • Deployment
  • Configuration

    • Coze Agent
    • Dify Agent
    • Alibaba Cloud Bailian Agent
  • Upgrade

    • Geek-Agent v1.0.2
    • Geek-Agent v1.0.3
  • GeekAI-PLUS (With Admin Panel)
  • GeekAI-Agent (With Admin Panel)
  • AI Study Notes

    • 01-Basic Concepts of Stable Diffusion
    • 02-Core Technology Decryption of DeepSeek R1
    • 03-DeepSeek R1 User Guide (Continuously Updated)
    • 03-Some Personal Thoughts on AI Agent
    • 04-Understanding MCP and A2A Protocols
  • Tech Community
  • GitHub
  • Gitee
  • GitCode
  • 简体中文
  • en-US
GitHub
  • Guide

    • Introduction
    • Quick Deployment
    • Advanced Deployment
  • Configuration

    • AI Drawing Configuration
    • Music and Video
    • File Storage Configuration
  • Upgrade

    • Smooth Upgrade
  • Development

    • Development and Build
    • How to Skip License Verification
  • Guide

    • Introduction
    • Deployment
  • Configuration

    • Coze Agent
    • Dify Agent
    • Alibaba Cloud Bailian Agent
  • Upgrade

    • Geek-Agent v1.0.2
    • Geek-Agent v1.0.3
  • GeekAI-PLUS (With Admin Panel)
  • GeekAI-Agent (With Admin Panel)
  • AI Study Notes

    • 01-Basic Concepts of Stable Diffusion
    • 02-Core Technology Decryption of DeepSeek R1
    • 03-DeepSeek R1 User Guide (Continuously Updated)
    • 03-Some Personal Thoughts on AI Agent
    • 04-Understanding MCP and A2A Protocols
  • Tech Community
  • GitHub
  • Gitee
  • GitCode
  • 简体中文
  • en-US
GitHub
  • GeekAI-Plus

    • Introduction
    • Quick Deployment
    • Advanced Deployment
    • Windows System Deployment
    • Deploy with Baota
    • Common Errors
  • Configuration

    • API Token Configuration
    • AI Drawing Configuration
    • Music and Video
    • File Storage Configuration
    • Payment Configuration
    • Gitee AI API Integration Guide
    • Other Service Configurations
    • Operational Strategies
  • Upgrade

    • Smooth Upgrade
    • GeekAI-PLUS-v4.1.6
    • GeekAI-PLUS-v4.1.8
    • GeekAI-PLUS-v4.1.9
    • GeekAI-PLUS-v4.2.1
    • GeekAI-PLUS-v4.2.2
    • GeekAI-PLUS-v4.2.3
    • GeekAI-PLUS-v4.2.4
  • Development

    • Development and Build
    • How to Skip License Verification

Version Updates

The latest version of GeekAI-Plus is v4.2.3, with the following updates:

  • Feature optimization: Added model grouping and model descriptions, improved model selection experience with card display mode.
  • Feature optimization: Enhanced the clarity of mind map downloads and fixed issues with incomplete content after dragging and zooming.
  • Bug fix: Fixed the issue where copying instructions for already drawn images in the MJ drawing page was invalid.
  • Feature optimization: MJ drawing resolution now supports customization, prioritizing the --ar parameter in prompts.
  • Bug fix: Fixed spelling errors in MJ drawing U1-V1.
  • Feature optimization: Supports automatic migration of database table structures, eliminating the need for manual SQL execution.
  • Feature optimization: Removed text animation effects from the homepage.
  • Feature optimization: Added expand/collapse functionality for conversation lists in the chat page.
  • Feature optimization: Added AI "thinking" animation effects in the chat page.

International Servers

For deployment on domestic servers, domain registration is required for resolution. The domain registration process is somewhat complex, as you may know. If you prefer not to register, you can deploy the system on an international server. However, many international servers are very slow for domestic access. After testing multiple providers, CloudDone offers lower latency with 1GiB bandwidth, providing relatively smooth access from China.

One-Click Automatic Deployment

We provide a one-click deployment script for geekai-plus. Simply run the following command on your server to complete the deployment:

curl -fsSL https://img.r9it.com/geekai/geekai-install.sh -o geekai-install.sh && chmod +x geekai-install.sh && sudo ./geekai-install.sh

Install Docker

We recommend using containers for the runtime environment, so you need to install Docker and Docker Compose first. Skip this step if they are already installed.

Ubuntu Online Installation

  1. Add Docker's official repository by running the following script in the terminal:

    # Add Docker's official GPG key:
    sudo apt-get update
    sudo apt-get install ca-certificates curl gnupg
    sudo install -m 0755 -d /etc/apt/keyrings
    curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
    sudo chmod a+r /etc/apt/keyrings/docker.gpg
    
    # Add the repository to Apt sources:
    echo \
    "deb [arch="$(dpkg --print-architecture)" signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \
    "$(. /etc/os-release && echo "$VERSION_CODENAME")" stable" | \
    sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
    sudo apt-get update
  2. Install Docker and Docker Compose:

    sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin docker-compose -y

Ubuntu Offline Installation

Recently, Docker-related official services have been restricted, leading to slow or failed downloads during installation. If you encounter this issue, you can try using the offline installation package I provided. (Note: Currently only suitable for Ubuntu-22.04 systems.)

Baidu Netdisk Download Link Extraction code: agvf

After downloading, run the installation script:

sudo sh install.sh

CentOS Online Installation

  1. Remove the default Docker installation:

    sudo yum remove docker \
                        docker-client \
                        docker-client-latest \
                        docker-common \
                        docker-latest \
                        docker-latest-logrotate \
                        docker-logrotate \
                        docker-engine -y
  2. Add the repository:

    sudo yum install -y yum-utils
    sudo yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo
  3. Install Docker and Docker Compose:

    sudo yum install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin docker-compose

    For other operating systems, refer to the official installation guide: https://docs.docker.com/engine/install/. Below, we will demonstrate how to run these containers. Assume all Docker containers are running in the /opt/GeekAI directory.

Video Deployment Tutorial

If you prefer learning deployment through videos, watch the GeekAI Plus Latest Deployment Tutorial.

Deploy Community Edition

First, clone the project:

git clone https://github.com/yangjian102621/geekai.git
# If GitHub is inaccessible, use the Gitee address:
git clone https://gitee.com/blackfox/geekai.git

Start the project:

cd deploy # Switch to the `deploy` directory
docker-compose up -d

Deploy Plus Edition

First, install Git if it is not already installed:

# Ubuntu installation:
sudo apt-get install git -y
# CentOS installation:
sudo yum install git -y

Then, clone the project:

git clone https://github.com/yangjian102621/geekai-plus.git
# If GitHub is inaccessible, use the Gitee address:
git clone https://gitee.com/blackfox/geekai-plus-open.git

By default, the X86_AMD64 Docker image is pulled. If you are using ARM architecture, modify the docker-compose.yaml file to update the image names for geekai-api and geekai-web:

  • Change geekai-plus-api:v4.0.8-amd64 to geekai-plus-api:v4.0.8-arm64.
  • Change geekai-plus-web:v4.0.8-amd64 to geekai-plus-web:v4.0.8-arm64.

Deploy Customized Edition

If you have customized the project and want to deploy your version, simply package your customized version into an image and update the image addresses in the docker-compose.yaml file. For detailed build and packaging instructions, refer to GeekAI Development Build.

Start the Project

docker-compose up -d

Once all images are started, logs similar to the following will be displayed:

Status: Downloaded newer image for registry.cn-shenzhen.aliyuncs.com/geekmaster/geekai-plus-web:v4.0.9-amd64
Creating geekai-mysql ... done
Creating geekai-redis ... done
Creating geekai-api   ... done
Creating geekai-web   ... done

Note:

Container startup completion does not mean successful startup. Since the one-click deployment script starts 6 containers with dependencies, multiple restarts may occur before normal operation. After the first successful startup, wait 30 seconds to 2 minutes before accessing the system.

You can then access the following addresses:

  • Frontend access: http://localhost:8080/chat (Automatically redirects to the mobile page on mobile devices).
  • Admin backend: http://localhost:8080/admin.
  • Mobile access: http://localhost:8080/mobile.
  • Default admin credentials: admin/admin123.
  • Default frontend demo credentials: 18888888888/12345678.

Note: The service cannot be used immediately after successful startup. You need to add API KEY first.

Edit this page on GitHub
Prev
Introduction
Next
Advanced Deployment
极客学长 © 2022-2025 版权所有 粤ICP备19122051号-1