.. _rcc-linux-ref:

Install |RCC| on Linux
======================

.. important::

    * The installer depends on Python 2.6 or 2.7 being available on the system.
    * Do not rename the installer binary it contains important platform and
      version information which is required.
    * Failure to start the installer could be due to a partial download, please
      retrieve the binary once more and try again.

Prerequisites
-------------

If you wish to use a MySQL or PostgreSQL database with |RCEE| you should set
up and configure the database before installation. For more information,
see the :ref:`Supported Databases <enterprise:rhodecode-database-ref>` section.

Download The Latest Package
---------------------------

To get the latest |RCC| package use the following steps:

1. Download the latest |RCC| installer from our website or your
   `rhodecode.com`_ profile page. If you don't have an account, sign up
   at `rhodecode.com/register`_.
2. Open a terminal and navigate to the downloaded package.
3. Change the permissions of the downloaded file using the following example:
   ``chmod 755 RhodeCode-installer-*``
4. Run the |RCC| installer and accept the End User Licence using the
   following example: ``./RhodeCode-installer-*``

If you read the licence on the command line, use ``q`` to exit the reader.
Use the following example to complete the above steps:

.. code-block:: bash

    # Navigate to the download and change permissions
    $ cd Downloads/
    $ chmod 775 <RhodeCode-installer>
    $ ./<RhodeCode-installer>

    Do you accept the RhodeCode Control license?
    Press [Y] to accept license and [V] to view license text: y

    Directory `/opt/rhodecode` does not exist.
    To create `/opt/rhodecode` you need to run:

    mkdir -m 0755 -p /opt/rhodecode && chown <user> /opt/rhodecode
    Press [X] to execute above command via sudo: X

    20%  [ ###############------------------------------------ ]

    Installation successful!

    # To access the commands you need to open a new terminal
    $ rccontrol status
    No instances exist.

.. note::

    If you receive an error related to ``getpwuid(): uid not found`` it means
    that there is a discrepancy in the active user account.  This has been known
    to happen when the local user shares the name of one being managed through
    Activity Directory and Centrify.


After installation you will need to open a new terminal, source your existing
session or use ``~/.rccontrol-profile/bin/rccontrol`` directly to access the
|RCC| commands.

* To install |RCEE|, see the :ref:`rce-cli-install-ref` section.
* For full |RCC| command line functionality, see the :ref:`rcc-cli` section.

Running at Boot
---------------

Please refer to the :ref:`supervisor-setup` section.

Uninstall |RCC|
---------------

To uninstall |RCC|, use the following steps:

1. Open a terminal
2. Enter the following command ``rccontrol self-destroy``
3. Enter ``y`` when prompted to confirm

.. note::

   On Windows this should be done through the :guilabel:`Add/Remove` menu.  For
   more details see the :ref:`rcc-windows-ref` section.

.. _rhodecode.com/register: https://rhodecode.com/register
.. _rhodecode.com: https://rhodecode.com