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:
- 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.
- Open a terminal and navigate to the downloaded package.
- Change the permissions of the downloaded file using the following example:
chmod 755 RhodeCode-installer-*
- 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.
- To install RhodeCode Enterprise, see the Install RhodeCode Community or RhodeCode Enterprise section.
- For full RhodeCode Control command line functionality, see the RhodeCode Control CLI Guide section.
Running at Boot¶
Please refer to the Supervisor Setup section.
Uninstall RhodeCode Control¶
To uninstall RhodeCode Control, use the following steps:
- Open a terminal
- Enter the following command
rccontrol self-destroy
- 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.