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 | |
64-bit macOS | |
64-bit Linux | |
32-bit Linux | |
64-bit Windows | |
32-bit Windows |
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 repoStep 3: Test Codeup-CLI
For example, on Linux, execute the following command to check if Codeup-CLI works:
./codeup-cli --helpTroubleshooting:
For permission-related issues, execute the following command on Linux/Mac to grant permissions.
chmod +x ./codeup-cliFor 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.
If you are using SSH for connection, see Configure SSH keys for instructions.
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.