Tutorial: How to Install RhodeCode on Windows 11

RhodeCode is an open-source platform for source code management. In this tutorial, we will guide you on how to install RhodeCode on Windows 11 using the Git Bash terminal.

Prerequisites

• A Windows 11 computer with administrative privileges
• Git Bash terminal installed
• Python 3.7 or above installed
• PostgreSQL 9.5 or above installed

Step 1: Clone RhodeCode

1. Open Git Bash terminal.

2. Change to the directory where you want to clone RhodeCode.

3. Clone the RhodeCode repository by running the following command:

    git clone https://code.rhodecode.com/rhodecode-enterprise-ce.git
   

Step 2: Install RhodeCode dependencies

1. Open Git Bash terminal.

2. Change to the RhodeCode directory by running the following command:

    cd rhodecode-enterprise-ce
   

3. Create a virtual environment by running the following command:

    python -m venv venv
   

4. Activate the virtual environment by running the following command:

    source venv/Scripts/activate
   

5. Install the required dependent packages by running the following command:

    python -m pip install -r requirements.txt
   

Step 3: Configure RhodeCode

1. Open Git Bash terminal.

2. Change to the conf directory by running the following command:

    cd rhodecode-enterprise-ce/confs
   

3. Copy the sample file rhodecode.ini.sample to rhodecode.ini:

    cp rhodecode.ini.sample rhodecode.ini
   

4. Open the rhodecode.ini file in a text editor and modify the following parameters:

    # PostgreSQL database settings
    db_url = postgresql://username:password@localhost/databasename
   
    # email settings
    smtp_server = smtp.example.com
    smtp_port = 587
    smtp_username = username
    smtp_password = password
   
    # secret key
    secret_key = xxxx
   

5. Save the changes and exit the text editor.

Step 4: Create the RhodeCode database

1. Open Git Bash terminal.

2. Change to the RhodeCode directory by running the following command:

    cd rhodecode-enterprise-ce
   

3. Activate the virtual environment by running the following command:

    source venv/Scripts/activate
   

4. Create the RhodeCode database by running the following command:

    paster setup-rhodecode [email protected] --password=admin [email protected] --force-yes
   

5. Complete the database upgrade by running the following command:

    paster upgrade
   

Step 5: Start RhodeCode

1. Open Git Bash terminal.

2. Change to the RhodeCode directory by running the following command:

    cd rhodecode-enterprise-ce
   

3. Activate the virtual environment by running the following command:

    source venv/Scripts/activate
   

4. Run the following command to start the RhodeCode server:

    paster serve rhodecode.ini
   

5. RhodeCode will start on http://localhost:5000 by default.

Conclusion

Congratulations! You have successfully installed RhodeCode on your Windows 11 computer. You can now start using RhodeCode to manage your source code.