Repolode
Valour-Software

Valour-Software/Valour

Open-source community chat platform built with .NET and Blazor, with channels, voice and video, and self-hostable federation.

Open-source alternative to:Discord

Stars
400
Forks
43
Open issues
97
Last commit
2 days ago

What is it?

Valour is a community platform where each community is called a planet. A planet can include chat channels, thread feeds, wikis, voice and video calls, roles, an in-app economy, and a village view where members move around and meet. The client supports tabs, split views, and multiple open conversations at once. Apps are available in the browser, as a Mac Catalyst build, and as an Android app.

The codebase is written in C# on .NET, with a shared Blazor UI used by the browser and native hosts. The server provides HTTP APIs and SignalR connections, and bots use the same SDK and API contracts as the client. Entity Framework handles the database layer, with PostgreSQL and Redis as the backing services.

Self-hosting uses a Docker Compose bundle that includes the application, PostgreSQL, Redis, Caddy for HTTPS, and filesystem media storage. Optional federation lets a hub manage accounts and a registry while independent community nodes host planets on their own domains. Voice self-hosting uses a LiveKit overlay.

Key features

  • 01Planets with chat channels, thread feeds, wikis, and roles
  • 02Voice and video calls
  • 03Tabbed client with split views and multiple open conversations
  • 04Self-hosted Docker Compose deployment with PostgreSQL, Redis, and Caddy
  • 05Federation that lets community nodes host planets on their own domains
  • 06Bots built on the same SDK and API as the client

Use cases

  • Running a private chat and voice community on your own server
  • Hosting several communities across independent domains through federation
  • Building bots or integrations against the Valour API and SDK
  • Studying a production-style .NET and Blazor application with SignalR

Quick start

  1. 1

    Copy the example environment file

    cp .env.example .env
  2. 2

    Edit .env to set your domain, database password, admin credentials, and DATAPROTECTION__KEK

  3. 3

    Start the Docker Compose services from the repository root

    docker compose up -d

Things to know

  • Licensed under AGPL-3.0, a copyleft license that requires sharing modified source code, including for network use.
  • Self-hosting needs a public domain, inbound ports 80 and 443, and a generated DATAPROTECTION__KEK secret, since Compose will not start without it.
  • Development setup needs .NET SDK 11 preview, PostgreSQL, and Redis.

In collections

Topics

FAQ

What is Valour?
Open-source community chat platform built with .NET and Blazor, with channels, voice and video, and self-hostable federation. Valour is a community platform where each community is called a planet. A planet can include chat channels, thread feeds, wikis, voice and video calls, roles, an in-app economy, and a village view where members move around and meet. The client supports tabs, split views, and multiple open conversations at once. Apps are available in the browser, as a Mac Catalyst build, and as an Android app.
Is Valour free to use? What license does it have?
Valour is open source under the AGPL-3.0 license. Check the license terms before using it in commercial products.
Is Valour still maintained?
Actively maintained. The last commit to Valour was on Nov 6, 2026.
What can I use Valour for?
Running a private chat and voice community on your own server Hosting several communities across independent domains through federation Building bots or integrations against the Valour API and SDK Studying a production-style .NET and Blazor application with SignalR
How do I install Valour?
Copy the example environment file: cp .env.example .env Edit .env to set your domain, database password, admin credentials, and DATAPROTECTION__KEK Start the Docker Compose services from the repository root: docker compose up -d
Where can I get Valour?
The source code and installation instructions are on GitHub: https://github.com/Valour-Software/Valour

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects