# GitRiver

> A self-hosted git platform: a single Rust binary and a single PostgreSQL database. Git hosting, CI/CD, container and package registries, issues, pull requests, GitOps deployment, team knowledge and an LLM assistant.

- The current version is 1.1.0.
- Three editions: Community (free, with no limit on people or repositories), Pro (seat-level capabilities) and Max (instance-level capabilities: SAML, SCIM, LDAP, audit log, quotas, custom branding).
- You pay for assigned seats, not for every account created.
- In Max, everyone who signs in only through SAML or LDAP needs a seat too: without one such an account signs in but cannot work, and once the grace period ends corporate sign-in closes; password and OAuth sign-in remain.
- Prices are published on the site: in roubles on gitriver.ru, in US dollars on gitriver.com.

## Main

- [Features: the full list by area](https://gitriver.com/features)
- [Pricing, editions and the seat calculator](https://gitriver.com/pricing)
- [Installation: image, deb and rpm packages, Helm chart](https://gitriver.com/download)
- [Release history](https://gitriver.com/changelog)
- [Frequently asked questions](https://gitriver.com/faq)
- [Public tracker: report a bug or propose a capability](https://gitriver.com/issues)

## Documentation

### Getting Started

- [Installation](https://gitriver.com/docs/installation)
- [First Steps](https://gitriver.com/docs/quick-start)
- [Configuration](https://gitriver.com/docs/configuration)

### Administrator Guide

- [Users & Groups](https://gitriver.com/docs/users-and-groups)
- [Repositories](https://gitriver.com/docs/repositories)
- [Pull Requests](https://gitriver.com/docs/pull-requests)
- [Issues](https://gitriver.com/docs/issues)
- [Branch Protection](https://gitriver.com/docs/branch-protection)
- [CI/CD Pipelines](https://gitriver.com/docs/ci-cd)
- [CI/CD: Advanced](https://gitriver.com/docs/ci-advanced)
- [Container Registry](https://gitriver.com/docs/container-registry)
- [Package Registry](https://gitriver.com/docs/package-registry)
- [GitOps Deploy (RiverCD)](https://gitriver.com/docs/deploy)
- [Notifications](https://gitriver.com/docs/notifications)
- [Security](https://gitriver.com/docs/security)
- [Authentication](https://gitriver.com/docs/auth)
- [Pages & Wiki](https://gitriver.com/docs/pages-and-wiki)
- [Releases](https://gitriver.com/docs/releases)
- [Import & Mirroring](https://gitriver.com/docs/migration)
- [DORA Metrics](https://gitriver.com/docs/dora-metrics)
- [Knowledge & Code Index](https://gitriver.com/docs/knowledge)
- [LLM Assistant](https://gitriver.com/docs/ai-assistant)
- [Backup & Restore](https://gitriver.com/docs/backup)
- [Licensing](https://gitriver.com/docs/licensing)

### Reference

- [Upgrading 1.0.0 → 1.1.0](https://gitriver.com/docs/upgrade)
- [CI/CD: Reference](https://gitriver.com/docs/ci-reference)
- [/api/v1 Compatibility](https://gitriver.com/docs/api-compatibility)
- [Load Benchmark](https://gitriver.com/docs/performance)
- [Troubleshooting](https://gitriver.com/docs/troubleshooting)