sharkord is a free, open source collaboration & communication project written in TypeScript and released under MIT. It has 1,496 GitHub stars, 134 forks and 52 open issues, and was last pushed 6 days ago. On this registry it ranks #32 of 41 tracked projects in Collaboration & Communication, with 5 head-to-head comparisons available. It gained 2 stars over the last 3 tracked days.

What is sharkord?

What it is

Sharkord is a lightweight, self-hosted, open-source chat server written in TypeScript under the MIT license. It provides voice, video, text, and screen sharing for small groups that want privacy, simplicity, and full control over their data. The project lives in the Discord-like collaboration and communication ecosystem, and its topics emphasize realtime messaging, privacy, data ownership, and self-hosting.

The concrete problem it solves is the need for a real-time communication platform that can run on a user's own infrastructure instead of a hosted service. The README describes it as bringing the most important Discord-like features to your own infrastructure, with voice, video, and screen sharing without the bloat or surveillance. It is distributed as a standalone binary that bundles both server and client components, and it is currently in alpha stage.

Key capabilities

  • Voice channels support video and screen sharing through a built-in mediasoup SFU.
  • Text channels are grouped into categories and include threads, replies, reactions, pins, search, custom emoji, mentions, and channel references.
  • Direct messages allow private conversations between members.
  • Roles and permissions can be configured with per-channel overrides for individual roles and users.
  • Invites can have usage limits and automatic role assignment.
  • File uploads support per-user storage quotas and optional signed URLs.
  • Plugins extend both server and client through the plugin SDK.

Who uses it and how

  • Small groups that want a self-hosted Discord-like server can run Sharkord on their own machine or server.
  • Users can install the standalone binary for Windows, macOS, or Linux, then open the client in a browser at http://localhost:4991.
  • Operators can deploy the Docker image sharkord/sharkord:latest with TCP and UDP port mappings and a mounted ./data directory.
  • Teams can use text channels, direct messages, voice channels, video, and screen sharing for day-to-day collaboration.
  • Developers can extend the platform with plugins that target both the server and the client.

Getting started

The typical installation methods are downloading the latest standalone binary from the GitHub Releases page or running the sharkord/sharkord:latest Docker image. On first launch, Sharkord creates a secret token printed to the console, which grants owner access and signs session and file URLs, so it must be stored securely before opening the web client at http://localhost:4991.

When to use it — and when not to

Sharkord is appropriate for small groups that want self-hosted realtime chat and can tolerate an alpha-stage product with bugs, incomplete features, and breaking changes. It is less suitable for teams that need a mature, managed platform or cannot operate the server, preserve the owner token, expose the required ports, and manage the data directory. The project's main trade-off is control over data and infrastructure in exchange for self-hosting responsibility and current instability.

project readme (upstream, from github) — read inline

Sharkord

A lightweight, self-hosted real-time communication platform

Version License Downloads Last Commit

Bun Mediasoup

ko-fi

What is Sharkord?

[!NOTE] Sharkord is in alpha stage. Bugs, incomplete features and breaking changes are to be expected.

Sharkord is a self-hosted communication platform that brings the most important Discord-like features to your own infrastructure. Voice, video, and screen sharing without the bloat or surveillance.

Screenshots

Sharkord Screenshot

Features

  • Voice channels with video and screen sharing, over a built-in mediasoup SFU
  • Text channels grouped into categories, with threads, replies, reactions, pins and search
  • Direct messages between members
  • Roles and permissions, with per-channel overrides for individual roles and users
  • Custom emoji, mentions and channel references
  • Invites with usage limits and automatic role assignment
  • File uploads with per-user storage quotas and optional signed URLs
  • Plugins that extend both server and client, through the plugin SDK

Docs

For detailed documentation, please visit our Documentation.

Wanna Try It Out?

Check out the Live Demo at demo.sharkord.com.

Getting Started

Sharkord is distributed as a standalone binary that bundles both server and client components. Get started by downloading the latest release for your platform from the Releases page. We ship binaries for Windows, macOS, and Linux.

Linux x64
curl -L https://github.com/sharkord/sharkord/releases/latest/download/sharkord-linux-x64 -o sharkord
chmod +x sharkord
./sharkord
Docker

Sharkord can also be run using Docker. Here's how to run it:

docker run \
  -p 4991:4991/tcp \
  -p 40000:40000/tcp \
  -p 40000:40000/udp \
  -v ./data:/home/bun/.config/sharkord \
  --name sharkord \
  sharkord/sharkord:latest

[!WARNING] Upon first launch, Sharkord creates a secret token and prints it to the console. It is both the credential that grants owner access and the key your server signs every session and file URL with, so anyone who obtains it can take ownership and impersonate any account. Keep it out of logs, screenshots and issue reports, store it securely, and do not lose it.

Once the server is running, open your web browser and navigate to http://localhost:4991 to access the Sharkord client interface. If you're running the server on a different machine, replace localhost with the server's IP address or domain name.

Check out our Documentation for more detailed setup instructions, configuration options, and troubleshooting tips.

Contributing

We welcome contributions! Please see our Contributing Guide for details, and Development for running Sharkord locally.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

Built with amazing open-source technologies:

Made with ❤️ by the Sharkord team

GitHubIssuesDiscussions

Frequently asked questions

Is sharkord free to use?

sharkord is open source under the MIT licence. There is no licence fee and no seat count — you can self-host it or, where the project offers one, pay a vendor for a managed version instead.

What does sharkord do?

Lightweight, self-hosted, open-source chat server with voice, video, text, and screen sharing. Built for small groups who want privacy, simplicity, and full con

What is sharkord written in?

sharkord is primarily written in TypeScript. Its source is publicly available at https://github.com/Sharkord/sharkord, and it has 1,496 GitHub stars.