Install RhodeCode Control 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 RhodeCode Enterprise you should set up and configure the database before installation. For more information, see the Supported Databases section.

Download The Latest Package

To get the latest RhodeCode Control package use the following steps:

  1. Download the latest RhodeCode Control 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 RhodeCode Control 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:

# 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 RhodeCode Control commands.

Running at Boot

Please refer to the Supervisor Setup section.

Uninstall RhodeCode Control

To uninstall RhodeCode Control, 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 Add/Remove menu. For more details see the Install RhodeCode Control on Windows section.