All Products
Search
Document Center

Alibaba Cloud DevOps:Install Codeup-CLI

Last Updated:Jun 23, 2025

Learn how to install the local migration tool Codeup-CLI.

Procedure overview

Follow the steps to use Codeup-CLI to migrate code repositories:

Step 1: Download Codeup-CLI

Select and download the proper version of Codeup-CLI based on your system:

System type

Download

macOS ARM 64-bit

Download

64-bit macOS

Download

64-bit Linux

Download

32-bit Linux

Download

64-bit Windows

Download

32-bit Windows

Download

Step 2: Install Codeup-CLI

After download, extract it to a directory as follows:

// Create a directory as workspace locally.
mkdir workspace

// Change current directory to the workspace.
cd workspace

// Copy Codeup-CLI to the current directory.
cp ~/Downloads/codeup-cli ./

// Create a new directory to store third-party repositories to be migrated.
mkdir repo

Step 3: Test Codeup-CLI

For example, on Linux, execute the following command to check if Codeup-CLI works:

./codeup-cli --help

Troubleshooting:

  • For permission-related issues, execute the following command on Linux/Mac to grant permissions.

    chmod +x ./codeup-cli
  • For the message below, check if the version of Codeup-CLI matches your system. If not, download the correct version of Codeup-CLI and reinstall it.

    Bad CPU type in executable

Step 4: Select the target platform

Codeup-CLI supports migrations from the following repositories:

  • Common third-party repositories, such as Gitee, Coding, and GitHub.

  • Local repositories.

(Optional) Further steps

1. Configure authentication for push and pull on Codeup

When using Codeup to push and pull code, user authentication is required.

2. Update remote repository URL

After migration, the remote repository URL needs to be updated to the one generated from Codeup.

  • Update the remote repository URL locally.

    // To view the remote repository URL, run the following command:
    git remote -v
    // To modify the remote reository URL, run the following command:
     git remote set-url origin <new git clone address from Codeup>
  • Update repository addresses in third-party systems.

    • If you push or pull code on a third-party platform, update the remote repository URL on the platform.

    • If the third-party platform uses HTTPS to access the code repository, you need to configure user authentication on the platform.