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

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 --user=admin@example.com --password=admin --email=admin@example.com --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.

If you want to self-host in an easy, hands free way, need an external IP address, or simply want your data in your own hands, give IPv6.rs a try!