Perintah git remote add adalah instruksi fundamental dalam Git yang digunakan untuk menghubungkan repositori lokal di komputer Anda ke repositori jarak jauh (remote repository) seperti GitHub. Perintah ini berfungsi mendaftarkan alamat URL server tujuan agar Git mengetahui ke mana kode sumber harus dikirim saat perintah push dijalankan.
Berdasarkan dokumentasi teknis pengelolaan repositori dan panduan unggah folder dengan baris perintah, berikut adalah tahapan mendalam dan sintaks lengkap untuk menghubungkan serta mengunggah proyek lokal Anda ke GitHub menggunakan perintah terminal.
Sintaks Dasar Git Remote Add
Sebelum mengeksekusi perintah, pastikan Anda telah membuat repositori kosong di platform GitHub. Sintaks umum yang digunakan di terminal atau command prompt adalah sebagai berikut:
git remote add [nama-remote] [url-repositori-github]
Secara konvensional, nama remote yang paling sering digunakan adalah origin, namun Anda bebas mendefinisikan nama lain sesuai kebutuhan manajemen proyek.
Tabel Parameter Perintah Git Remote
| Komponen Perintah | Fungsi dan Penjelasan |
|---|---|
git remote add |
Perintah utama untuk menambahkan koneksi repositori remote baru. |
origin |
Nama alias standar untuk merepresentasikan server repositori jarak jauh utama. |
https://github.com/... |
URL unik HTTPS atau SSH dari repositori GitHub tempat kode akan disimpan. |
git remote -v |
Perintah verifikasi untuk mengecek daftar URL remote yang sudah terhubung. |
Langkah-Langkah Menghubungkan Folder Lokal ke GitHub
Untuk mengunggah folder atau proyek yang sudah ada di komputer Anda ke GitHub menggunakan baris perintah, ikuti urutan langkah teknis berikut:
- Inisialisasi Git: Buka terminal pada direktori folder proyek Anda, lalu ketik
git inituntuk menginisialisasi folder sebagai repositori Git lokal. - Tambah dan Commit Berkas: Masukkan seluruh file ke dalam area staging dengan perintah
git add .diikuti dengan membuat commit awal menggunakangit commit -m "Commit pertama". - Hubungkan ke GitHub: Jalankan perintah
git remote add origin [URL_GITHUB_ANDA]untuk menautkan repositori lokal ke GitHub. - Unggah Kode (Push): Kirimkan kode ke branch utama di GitHub menggunakan perintah
git push -u origin main(ataumastertergantung konfigurasi default branch Anda).
Troubleshooting Masalah Umum
Jika Anda mendapati pesan error seperti fatal: remote origin already exists, artinya nama remote tersebut sudah pernah didaftarkan sebelumnya. Anda dapat memperbarui URL remote yang ada dengan perintah git remote set-url origin [URL_BARU] atau menghapusnya terlebih dahulu menggunakan git remote remove origin.