|RCT| Overview

To install |RCT| correctly, see the installation steps covered in :ref:`install-tools`, and :ref:`config-rhoderc`.

Once |RCT| is installed, and the :file:`/home/{user}/.rhoderc` file is configured you can then use |RCT| on each |RCM| instance to carry out admin tasks. Use the following example to configure that file, and once configured see the :ref:`tools-cli` for more details.

# Get the status of each instance you wish to use with Tools
(venv)brian@ubuntu:~$ rccontrol status

 - NAME: momentum-1
 - STATUS: RUNNING
 - TYPE: Momentum
 - VERSION: 3.0.0-nightly-momentum
 - URL: http://127.0.0.1:10003

 - NAME: momentum-3
 - STATUS: RUNNING
 - TYPE: Momentum
 - VERSION: 3.0.0-nightly-momentum
 - URL: http://127.0.0.1:10007

Example :file:`/home/{user}/.rhoderc` file.

# Configure the .rhoderc file for each instance
# API keys found in your instance
[instance:enterprise-1]
api_host = http://127.0.0.1:10003/
api_key = 91fdbdc257289c46633ef5aab274412911de1ba9
repo_dir = /home/brian/repos

[instance:enterprise-3]
api_host = http://127.0.0.1:10007/
api_key = 5a925f65438d29f8d6ced8ab8e8c3d305998d1d9
repo_dir = /home/brian/testing-repos/

Example usage of |RCT| after |RCE| 3.5.0. From this version onwards |RCT| is packaged with |RCE| by default.

$ .rccontrol/enterprise-4/profile/bin/rhodecode-extensions --plugins \
    --instance-name=enterprise-4 --ini-file=rhodecode.ini

Writen new extensions file to rcextensions
Copied hipchat_push_notify.py plugin to rcextensions
Copied jira_pr_flow.py plugin to rcextensions
Copied default_reviewers.py plugin to rcextensions
Copied extract_commits.py plugin to rcextensions
Copied extract_issues.py plugin to rcextensions
Copied redmine_pr_flow.py plugin to rcextensions
Copied extra_fields.py plugin to rcextensions
Copied jira_smart_commits.py plugin to rcextensions
Copied http_notify.py plugin to rcextensions
Copied slack_push_notify.py plugin to rcextensions
Copied slack_message.py plugin to rcextensions
Copied extract_jira_issues.py plugin to rcextensions
Copied extract_redmine_issues.py plugin to rcextensions
Copied redmine_smart_commits.py plugin to rcextensions
Copied send_mail.py plugin to rcextensions