.. _rcc-upgrade:

Upgrade |RCC|
=============

To have access to the latest available releases from |RC| it is necessary
for you to trigger a check and potential update of |RCC|. This command will
connect to our servers and check if any new releases are available. It will
also upgrade the |RCC| if new version of it is available.

.. code-block:: bash

   $ rccontrol self-update

   Currently running RhodeCode Control "1.7.0"
   Downloading https://dls.rhodecode.com/linux/MANIFEST ...

   Latest version "1.7.0"
   No new version of RhodeCode Control available.

   Supervisord state is: RUNNING

See the :ref:`rcc-cli` section for more details.

Offline Upgrading
-----------------

If you are working in an offline environment it will be necessary to upgrade
|RCC| to get support for the latest |RCEE| and |VCS| releases.

1. Download the :file:`MANIFEST` file for your platform.

   * Linux: https://dls.rhodecode.com/linux/MANIFEST
   * Win64: https://dls.rhodecode.com/win64/MANIFEST

2. Check the contents of the ``MANIFEST`` file for |RCC|.

.. code-block:: bash

   19d5395c8da96983b049afdaf78a7426 https://dls.rhodecode.com/linux/RhodeCodeControl-1.3.0+x86_64-linux_774_233a2738f6fa_b8c3bae59b9f.tar.bz2
   cb2afef56a6cfdc9300cbbb4098ce032 https://dls.rhodecode.com/linux/RhodeCodeControl-1.3.0+i686-linux_774_233a2738f6fa_b8c3bae59b9f.tar.bz2

3. Download the |RCC| version matching you platform architecture.

4. Transfer the files to your offline computer.

5. Copy the files into the |RCC| cache.

   * Required files: ``MANIFEST`` and ``RhodeCodeControl-*.tar.bz2``
   * On Linux: :file:`/home/{user}/.rccontrol/cache`
   * On Windows: :file:`C:/\Program Files/\RhodeCode/\home/\{user}/\.rccontrol/\cache`

5. Execute the ``self-update`` command with the ``--offline`` option.

.. code-block:: bash

   $ rccontrol self-update --offline
   Currently running RhodeCode Control "1.7.0"
   Offline mode enabled. Using files from the local cache.

.. important::

   If you wish to also upgrade |RCEE| or the |VCS| offline you will need to
   download those packages and following similar steps.  For more details see
   the :ref:`offline-installer-ref` section.