DOWNLOADS
Server and SDKs, ready for your stack
Choose your architecture and client platform, then launch a fully self-hosted messaging system in minutes.
Free Basic edition (server)
Basic is free forever, no sign-up required. Current release v1.24.0, built for x86, ARM and LoongArch.
01 / Docker
Option 1: Docker Compose (recommended)
One command boots the full stack (server + PostgreSQL + Redis, schema auto-applied). The image is a multi-arch amd64 / arm64 build, served from Docker Hub.
curl -fsSLO https://balala.im/releases/v1.24.0/docker-compose.yml
docker compose up -dOr pull the image directly:
docker pull balalaim/imcore-basic:1.24.0In mainland China, pull from the Aliyun ACR mirror instead: crpi-zegbek7xpkekqods.cn-hangzhou.personal.cr.aliyuncs.im/balala/imcore-basic:1.24.0
For air-gapped environments, download the offline image bundle and import it with docker load:imcore-basic-v1.24.0-docker-amd64.tar.gz · imcore-basic-v1.24.0-docker-arm64.tar.gz
02 / Binary
Option 2: Bare binaries
A single Go binary with zero-dependency startup; bring your own PostgreSQL and Redis.
| Architecture | Typical platforms | Download |
|---|---|---|
linux-amd64 | Intel / AMD, Hygon, Zhaoxin | imcore-basic-v1.24.0-linux-amd64.tar.gz |
linux-arm64 | ARM servers, Kunpeng, Phytium | imcore-basic-v1.24.0-linux-arm64.tar.gz |
linux-loong64 | Loongson 3A5000/3A6000 (LoongArch) | imcore-basic-v1.24.0-linux-loong64.tar.gz |
Checksums (SHA256SUMS) ·After downloading, follow the quickstart to boot in one minute. Pro / Enterprise / Customer Service deploy the same way and unlock via license — contact sales.
Client SDKs
Official typed SDKs cover Web, React Native, WeChat Mini Programs, uni-app, Electron, Flutter and native mobile, with Web, Flutter, Android Compose and iOS SwiftUI UIKits. Versioned packages and platform setup guides are available below.
React Native / Expo
@imcore/sdk/react-native
install the JS/TS package, then connect AsyncStorage and NetInfo
WeChat Mini Program
@imcore/sdk/wechat-miniprogram
install the JS/TS package, then build npm in WeChat DevTools
uni-app
@imcore/sdk/uni-app
install the JS/TS package, then build with normal uni-app tooling
PC / Electron
@imcore/sdk/electron/*
install the JS/TS package; use its main and renderer subpaths
React UIKit (components)
@imcore/uikit
npm i <the .tgz URL or file> (also install @imcore/sdk)
Flutter UIKit (components)
imcore_uikit
unpack, then a pubspec path dependency (also depends on imcore_sdk)
Unity / .NET
im.balala.unity-sdk
Unity Package Manager → Install package from tarball (Unity 2021.3+)
Server Admin · Go
imcoreadmin
go mod edit -replace github.com/obihuang/imcore/clients/go=./unpacked-dir
Server Admin · Node
@imcore/admin
package.json file: dependency pointing at the unpacked dir (zero-dep TS)
Server Admin · Java
imcore-admin-java
unpack, then include as a gradle/maven source project (Java 17+, zero third-party deps)