selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

docker-chatgpt logo

Self-host docker-chatgpt

v2023.05.29

Self-hosted ChatGPT client with multi-model backend

ReleaseOpen SourceWTFPL
Updated3 years ago
Setup difficultyModerate
Stars
140
CPU
~1%
RAM
~10MB
Storage
~10MB
Ports
8090 (ChatGPT web client (frontend)), 8091 (Sparrow backend API server)
Requires
Sparrow backend
Docker
soulteary/chatgpt
Install with Docker
Main chat interface showing code generationConversation with image generationConversation using plugin functionalityModel switcher customization UIApplication settings panel

What is docker-chatgpt?

docker-chatgpt is a lightweight, self-hosted web client that replicates the ChatGPT interface while letting you plug in multiple AI backends. The frontend (soulteary/chatgpt) is a static Vue application served on port 8090; it talks to a separate Go service called Sparrow (soulteary/sparrow) on port 8091. Sparrow acts as a unified gateway: it can forward requests to the official OpenAI API, to private Midjourney or FlagStudio image-generation endpoints, or to a Claude-compatible WebSocket service. All components are distributed as Docker images and started with a single docker-compose.yml. The project emphasizes privacy — no telemetry, no external calls unless you configure them — and runs in roughly 10 MB of disk and memory. Features include a model switcher, plugin system (browsing, code interpreter), conversation history, i18n, and custom data-source connectors. The code is licensed under WTFPL (client) and Apache-2.0 (backend). The latest release is v2023.05.29 from May 2023; development appears inactive since then.

Should you self-host docker-chatgpt?

docker-chatgpt scores 41/100 on selfhost.directory (how scoring works) and ranks #53 of 69 in AI Chat. It has 140 GitHub stars.

There was no stable release in the past 12 months, so check the repository's recent activity before you rely on it.

Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is WTFPL-licensed.

Its closest alternative on selfhost.directory is openhands (87/100, 92 105 stars). It scores higher overall, so compare the two before you pick. See docker-chatgpt vs openhands side by side.

Features

  • Conversation history
  • Custom Data Sources
  • Data Control
  • Internationalization (I18N)
  • Model switcher
  • Multi-Model Support
  • OpenAI API proxy support
  • Plugin System
  • Privacy-focused
  • Response speed control

docker-chatgpt README

How to install docker-chatgpt

Install docker-chatgpt with Docker

Docker installed

docker pull soulteary/chatgpt docker pull soulteary/sparrow docker run -p 8090:8090 -e APP_PORT=8090 -e APP_HOSTNAME=http://localhost:8090 -e APP_UPSTREAM=http://sparrow:8091 soulteary/chatgpt docker run -p 8091:8091 -e WEB_CLIENT_HOSTNAME=http://localhost:8090 soulteary/sparrow

Run client and backend as separate containers

How to configure docker-chatgpt

  • APP_HOSTNAMEThe ChatGPT client domain, must match the frontend URL

    The ChatGPT client domain, must match the frontend URL

  • APP_PORT8090Service port for the chatgpt client (default 8090)

    Service port for the chatgpt client (default 8090)

  • APP_UPSTREAMThe ChatGPT backend upstream URL (Sparrow server)

    The ChatGPT backend upstream URL (Sparrow server)

  • CLAUDE_API_SECRETClaude API secret/key

    Claude API secret/key

  • CLAUDE_API_URLClaude API WebSocket URL (e.g., ws://localhost:8093/ws)

    Claude API WebSocket URL (e.g., ws://localhost:8093/ws)

  • ENABLE_CLAUDEEnable Claude integration

    Enable Claude integration

    values: "on"

  • ENABLE_CLAUDE_ONLYEnable Claude only mode

    Enable Claude only mode

    values: "on"

  • ENABLE_DATA_CONTROLEnable data control features

    Enable data control features

    values: "on"

  • ENABLE_FLAGSTUDIOEnable FlagStudio integration

    Enable FlagStudio integration

    values: "on"

  • ENABLE_FLAGSTUDIO_ONLYEnable FlagStudio only mode

    Enable FlagStudio only mode

    values: "on" or "off"

  • ENABLE_HISTORY_LISTEnable history list

    Enable history list

    values: "on"

  • ENABLE_I18NEnable internationalization

    Enable internationalization

    values: "on"

  • ENABLE_MIDJOURNEYEnable Midjourney integration

    Enable Midjourney integration

    values: "on"

  • ENABLE_MIDJOURNEY_ONLYEnable Midjourney only mode

    Enable Midjourney only mode

    values: "on"

  • ENABLE_MODEL_SWITCHEnable model switcher in UI

    Enable model switcher in UI

    values: "on"

  • ENABLE_OPENAI_APIEnable OpenAI 3.5 API

    Enable OpenAI 3.5 API

    values: "on"

  • ENABLE_OPENAI_OFFICIAL_MODELEnable OpenAI official models including plugin models

    Enable OpenAI official models including plugin models

    values: "on"

  • ENABLE_PLUGINEnable plugin system

    Enable plugin system

    values: "on"

  • ENABLE_PLUGIN_BROWSINGEnable plugin browsing capability

    Enable plugin browsing capability

    values: "on"

  • ENABLE_PLUGIN_CODE_INTERPRETEREnable plugin code interpreter

    Enable plugin code interpreter

    values: "on"

  • ENABLE_PLUGIN_PLUGIN_DEVEnable plugin model dev feature

    Enable plugin model dev feature

    values: "on"

  • FEATURE_NEW_UIEnable the new UI

    Enable the new UI

    values: "on"

  • FLAGSTUDIO_API_KEYFlagStudio API key

    FlagStudio API key

  • MIDJOURNEY_API_SECRETMidjourney API secret/key

    Midjourney API secret/key

  • MIDJOURNEY_API_URLMidjourney API WebSocket URL (e.g., ws://localhost:8092/ws)

    Midjourney API WebSocket URL (e.g., ws://localhost:8092/ws)

  • OPENAI_API_KEYOpenAI API Key

    OpenAI API Key

  • OPENAI_API_PROXY_ADDROpenAI API proxy address (e.g., http://127.0.0.1:1234)

    OpenAI API proxy address (e.g., http://127.0.0.1:1234)

  • OPENAI_API_PROXY_ENABLEEnable OpenAI API proxy

    Enable OpenAI API proxy

    values: "on"

  • RESPONSE_SPEED1Response generate speed multiplier (1x ~ 99x)

    Response generate speed multiplier (1x ~ 99x)

    values: 1-99

  • WEB_CLIENT_HOSTNAMEThe ChatGPT Web Client Domain for the backend

    The ChatGPT Web Client Domain for the backend

docker-chatgpt releases & version history

More in AI Chat

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…