In the self-host version of TypingMind, there are two main components.
1
The app server (NodeJS app)
This is where the data is received and processed. The app server provides two web portals: the Admin Panel for admins to configure the instance and the Chat Interface for your end users.
2
The app database (MySQL database)
This is where the data is securely stored.
Note: The system does not include an LLM model or an AI provider. TypingMind only provides the chat interface and the management system around it. After setting up the system, you will need to connect it to an AI provider (OpenAI's ChatGPT, Claude, Gemini, or a private LLM model that you run in your infrastructure).
System architecture diagram
Technical requirements
Two things are all you need to host TypingMind Teams.
Docker-compatible server
Runs the official TypingMind Docker image.
MySQL 8.x database
Stores your data, with 1+ CPU and 4GB+ RAM.
Installation
The setup process is straightforward and takes approximately 30 minutes.
1
Purchase Self-host license
Get your license key and access to the Docker image.
2
Set up a MySQL 8.x database
Use any MySQL hosting provider (must have 1+ CPU, 4GB+ RAM).
3
Configure environment variables
Set up database URL, SMTP, hostname, and license key.
4
Deploy Docker container
Pull and run the official Docker image on your infrastructure.
5
Connect your custom domain
Point your domain to the server.
6
Complete setup
Visit /setup URL to configure your instance via admin panel.
Updates
Software updates are released through the private GitHub repo.
The Business plan comes with 1 year of free updates.
Software updates will be released via the GitHub repo.
Auto-update: you can set up an automation to pull and redeploy anytime there's a new change in the GitHub repository.
After 1 year, you can renew your license to continue receiving updates.
Seats & renewal
Manage your license directly from the admin panel.
You can buy more seats/users anytime.
There is a payment link in the admin panel for you to buy and renew your self-host version.
Security & privacy
All data are stored in your MySQL database and never sent anywhere else.
There is strictly no user data sent out to any other external services. This can be verified using various black-box testing methods like monitoring network requests from the app. There are only three types of external network requests that will be made from the self-host app:
AI provider requests
Requests to OpenAI/Anthropic are the core functionality of the app, allowing you to chat with AI. If you use an internal private LLM, no requests to OpenAI/Anthropic will be made.
Update checks
Notify you when there is a new update. Sent to TypingMind's server with only the minimal information needed to check for updates.
License checks
Verify your self-host license and that you're using the correct number of users for your plan. Sent to TypingMind's server with no user data included.
Maximum security
SOC 2 Type II certified and GDPR compliant. Your data stays on your servers and is never used to train AI models.
Yes, the self-hosted version will receive updates and new features the same as the cloud version. You can update your self-hosted version by pulling the latest changes from the GitHub repository. Updates for the self-host version are delayed 1-3 weeks compared to the cloud version.
After purchase, you will immediately get access to the private GitHub repository with source code for deployment, the technical installation instructions, and a self-host instance key (valid for 1 instance with 5 users included).
No. You can only use the source code as-is to set up the TypingMind Teams in your infrastructure. The license do not give you permission to analyze, modify, resell, share, redistribute the source code.
You will only get the compiled source code. Modifying or redistributing the source code is not allowed.
All of your data are stored in your database hosted in your infrastructure. There is strictly no user data sent out to any other external services. This can be verified using various black-box testing methods like monitoring network requests from the app. For enterprises, we offer whitebox audit and testing with the full source code, please contact us if you need this. More details are available in our Privacy Policy: https://custom.typingmind.com/privacy.
No. Due to the nature of the software source code being non-returnable; refunds will not be provided under any circumstances.