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.

octo-server logo

Self-host octo-server

v1.24.0

AI-native team collaboration backend w/ agent orchestration

ReleaseOpen SourceApache-2.0
Updated9 hours ago
LanguageGo
Setup difficultyAdvanced
Stars
1 101
Ports
8090 (HTTP API (REST + WebSocket)), 6979 (gRPC callback listener for WuKongIM)
Requires
MySQL, Redis, WuKongIM
Docker
mininglamposs/octo-server
Install with Docker Compose

What is octo-server?

octo-server is the central Go backend of the OCTO platform, exposing REST and WebSocket APIs consumed by web, desktop, and mobile clients. It orchestrates Lobster AI agents (OpenClaw-powered digital doubles) as first-class conversation participants, handles authentication via token, cookie, or DH-sealed WebSocket frames, and enforces org-aware RBAC with per-channel ACLs. The server drives WuKongIM for real-time messaging, supports pluggable MySQL-compatible storage and S3-compatible object storage (MinIO, Aliyun OSS, Tencent COS, Qiniu, SeaweedFS), and integrates with push notification services (APNS, HMS, Mi, Vivo, Oppo, Firebase) and third-party OAuth (GitHub, Gitee). It can be deployed via the official Docker Compose stack (octo-deployment) or built as a standalone binary requiring Go 1.25+, MySQL 8, Redis 7, and a WuKongIM v2 instance. Licensed under Apache 2.0.

Should you self-host octo-server?

octo-server scores 53/100 on selfhost.directory (how scoring works) and ranks #37 of 110 in Chat. It has 1 101 GitHub stars.

It shipped 10 stable releases in the past year. The latest, v1.24.0, came out on 26 October 2026. New versions land roughly every 7 days.

Setup is advanced: plan for several services and some ongoing maintenance. An official Docker image is available. It is Apache-2.0-licensed and written mostly in Go.

Its closest alternative on selfhost.directory is Zulip (82/100, 26 128 stars). It scores higher overall, so compare the two before you pick. See octo-server vs Zulip side by side.

Features

  • Agent-Identity Gating
  • AI Agent Orchestration (Lobster)
  • gRPC Webhook Callback
  • Multi-tenant Architecture
  • Org-aware RBAC
  • Pluggable Object Storage
  • Pluggable SQL Storage
  • Push Notifications
  • Real-time Messaging (WuKongIM)
  • REST API
  • SMS Verification
  • Third-party OAuth Login
  • Webhook HMAC Verification
  • WebSocket API

octo-server README

How to install octo-server

Install octo-server with Docker Compose

Docker and Docker Compose
Environment variables
OCTO_DOMAIN, OCTO_HTTP_PORT, and others in docker/.env

git clone https://github.com/Mininglamp-OSS/octo-deployment.git cd octo-deployment ./setup.sh # interactive, generates docker/.env cd docker docker compose up -d docker compose ps # all services should reach (healthy)

Official OOTB deployment with server + admin + web + matter + smart-summary + WuKongIM + MySQL + Redis + MinIO + nginx

octo-server releases & version history

More in Application Management

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…