docs/source/index.rst

Welcome to RhodeCode rcstack documentation!
===========================================


=================
RhodeCode rcstack
=================

RhodeCode rcstack is a multi-node highly-scalable setup to run RhodeCode services.
It consists of all RhodeCode services required with additionally
Edge Router(Traefik with optional SSL) and Metrics Stack (Prometheus, Loki, Grafana) in single environment using Docker.

Using a docker-compose this setup creates following services for RhodeCode:



**Router (mandatory to run):**


.. code-block:: bash

    ./rcstack router --help


`Traefik <https://doc.traefik.io/traefik/>`_ aka Edge Router is responsible for handling all outgoing and incoming traffic to whole stack.
It can do SSL termination, and handle SSL traffic with certificate management.

Traefik listens to few defaults ports and
handles all incoming/outgoing traffic to the stack

- 80   (HTTP)
- 443  (HTTPS)
- 9443 (SSH for RhodeCode traffic)
- 3100 (Loki log aggregation)


**Services (mandatory to run):**

.. code-block:: bash

    ./rcstack services --help


- Database (defaults to PostgreSQL) Optionally can be replaced by MySQL, or own external database if needed.
- Redis, acts as cache and queue exchange
- ChannelStream - live websocket communications
- Elasticsearch (full text search backend)
- Nginx (static file service) proxy serving RhodeCode static files


**RhodeCode (mandatory to run):**

.. code-block:: bash

    ./rcstack rhodecode --help


- RhodeCode CE/EE web app
- VCSServer for GIT/SVN/HG support
- SSH server for cloning over SSH
- SVN webserver for SVN protocol support
- Celery workers for asynchronous tasks
- Celery beat for scheduler and automation tasks


**Metrics (Optional)**

.. code-block:: bash

    ./rcstack metrics --help

- Loki, logs aggregation
- Grafana, metrics Dashboard
- Prometheus, metrics time-series
- Statsd-exporter - statsd to Prometheus bridge
- Node-exporter - machine stats and usage
- Promtail - log scraping


.. toctree::
    :maxdepth: 1
    :hidden:
    :caption: Installation

    install/installation.rst
    install/upgrade.rst


.. toctree::
    :maxdepth: 1
    :hidden:
    :caption: Configuration

    configuration/configuration-overview.rst
    configuration/scaling-rhodecode.rst
    configuration/enable-ssl-on-traefik.rst
    configuration/data-volumes.rst
    configuration/set-license-file.rst


.. toctree::
    :maxdepth: 1
    :hidden:
    :caption: Migration

    migration/migration-to-docker.rst


.. toctree::
    :maxdepth: 1
    :hidden:
    :caption: Builds & Images

    builds/build-new-image.rst
    builds/building-images.rst

.. toctree::
    :maxdepth: 1
    :hidden:
    :caption: Changelog

    changes.rst