Cara Upload Project ke GitHub dari Nol untuk Pemula (Git, Commit, Push, dan Token)

Banyak panduan di sini menyuruhmu mengisi Git Repository URL. Kalau kamu belum pernah memakai Git, panduan ini membawamu dari nol sampai project-mu ada di GitHub dan bisa diambil servermu. Hasil akhirnya: update website atau bot cukup push dari komputer.

Git dan GitHub itu apa?

• Git adalah program di komputermu yang mencatat setiap perubahan pada project.
• GitHub adalah tempat menyimpan project itu di internet. Servermu mengambil kode dari sini.

Singkatnya: kamu menyimpan perubahan dengan Git, lalu mengirimnya ke GitHub.

Langkah 1: Pasang Git dan buat akun GitHub

1. Pasang Git sesuai sistemmu:
   • Windows: unduh dari git-scm.com/download/win, lalu jalankan installer dengan pengaturan bawaan. Ikut terpasang Git Bash (terminal untuk perintah di panduan ini) dan Git Credential Manager untuk login GitHub lewat browser. Pastikan versinya 2.29 atau lebih baru.
   • macOS: buka Terminal dan ketik git --version. Kalau Git belum terpasang, macOS menawarkan untuk memasangnya.
   • Linux: jalankan sudo apt install git-all (Debian atau Ubuntu) atau sudo dnf install git-all (Fedora).
2. Buka terminal (di Windows: Git Bash), lalu cek dengan:

git --version

3. Atur namamu sekali saja:

git config --global user.name "Nama Kamu"
git config --global user.email "[email protected]"

Nama dan email ini tercatat permanen di setiap commit yang kamu buat. Karena memakai --global, kamu cukup mengaturnya sekali.

4. Buat akun gratis di github.com. Baca Cara membuat akun GitHub.

Tidak punya komputer? Kamu bisa mengunggah file langsung lewat situs GitHub: buka repo, klik Add file, lalu Upload files. Batasnya 25 MiB per file dan 100 file sekali upload, jadi cara ini hanya cocok untuk project kecil. Jangan upload node_modules dan .env.

Langkah 2: Buat repository

1. Di GitHub, klik New repository.
2. Isi nama, misalnya bot-saya.
3. Pilih Private kalau project-mu tidak untuk umum. Pakai private untuk project yang berisi kode bisnis.
4. Jangan centang pilihan untuk membuat README, karena kamu akan mengunggah project yang sudah ada.
5. Klik Create repository. Salin alamat repo yang muncul, bentuknya https://github.com/username/bot-saya.git.

Langkah 3: Siapkan file .gitignore

Sebelum mengirim, beri tahu Git file apa yang tidak boleh ikut. Buat file bernama .gitignore di folder project, lalu isi:

node_modules
.env
.next

Ini penting: .env berisi token dan password, jangan sampai masuk GitHub. Alasannya ada di Menyimpan token dengan aman pakai .env.

Cara cepat membuatnya: di terminal, masuk ke folder project lalu jalankan touch .gitignore, kemudian buka file itu dengan editor teks.

Satu catatan: .gitignore hanya berlaku untuk file yang belum pernah dikirim. Kalau sebuah file sudah terlanjur masuk ke Git, hentikan pelacakannya dulu dengan git rm --cached nama-file (untuk folder pakai git rm -r --cached nama-folder), lalu commit.

Langkah 4: Kirim project ke GitHub

Buka terminal di folder project, lalu jalankan satu per satu. Ganti alamat repo dengan milikmu.

git init -b main
git add .
git commit -m "Commit pertama"
git remote add origin https://github.com/username/bot-saya.git
git remote -v
git push -u origin main

Arti tiap perintah:

Git versi lama: opsi -b butuh Git 2.28 atau lebih baru. Kalau muncul error, ganti baris pertama dengan git init.

Saat git push, kamu diminta masuk ke GitHub:

• Windows: jendela browser terbuka. Login di sana, dan kalau diminta, otorisasi aplikasinya serta selesaikan 2FA.
• macOS atau Linux: Git meminta username dan password. Di kolom password, isi token, bukan password akunmu, karena GitHub sudah tidak menerima password akun untuk Git. Baca Cara membuat token GitHub untuk server.

Setelah selesai, refresh halaman repo dan file-filemu sudah ada di sana. Pastikan .env dan node_modules tidak tampil. Jangan pernah mengirim password atau API key.

Langkah 5: Buat token supaya server bisa mengambil kode

Kalau repo-mu private, servermu butuh izin berupa token, bukan password GitHub.

Langkah lengkapnya ada di Cara membuat token GitHub untuk server. Ringkasnya: Settings, Developer settings, Fine-grained tokens, Generate new token, pilih repo-mu, lalu ubah Contents menjadi Read-only.

Repo yang publik tidak butuh token.

Langkah 6: Hubungkan ke panel

Di tab Startup servermu, isi kolom Git (nama kolomnya bisa sedikit berbeda tiap egg):

• Git Repository URL: alamat repo tadi.
• Branch: main.
• Git Username: username GitHub-mu (hanya repo private).
• Git Access Token: token dari Langkah 5 (hanya repo private).

Kolom ini hanya dipakai kalau folder server kosong.

Memperbarui project

Setelah mengubah kode di komputer, kirim lagi dengan tiga perintah:

git add .
git commit -m "Perbaiki perintah ping"
git push

Lalu di panel, jalankan Restart (pastikan Auto Update bernilai 1 supaya server mengambil perubahan terbaru).

Masalah yang sering muncul

Terlanjur memasukkan .env ke GitHub?

Menghapus file saja tidak cukup, karena commit lama masih menyimpan isinya dan bisa saja sudah tersalin ke tempat lain. Urutannya:

1. Cabut atau ganti dulu semua rahasianya. Reset token bot dan ganti password database yang ada di file itu. Caranya ada di Menyimpan token dengan aman pakai .env, bagian "Token sudah telanjur bocor".
2. Tempel nilai baru di file .env di server.
3. Hentikan pelacakan filenya: jalankan git rm --cached .env, lalu commit dan push.