Source code aplikasi, template web, dan ebook. Unduh dari akun setelah bayar. Lihat produk

Blog / Tutorial / PROSEDUR KONFIGURASI SSH KEY G...
Tutorial

PROSEDUR KONFIGURASI SSH KEY GITHUB PADA SERVER UBUNTU

AD

Admin HijrahKreativa

Penulis

03 Nov 2026
5 min read
38 views

PROSEDUR KONFIGURASI SSH KEY GITHUB PADA SERVER UBUNTU

Dokumen: SOP Infrastruktur dan Deployment
Versi: 1.0
Platform: Ubuntu Server
Repository: GitHub
Metode Autentikasi: SSH Key (Ed25519)


1. Tujuan

Dokumen ini menjelaskan prosedur konfigurasi autentikasi SSH Key antara server Ubuntu dan GitHub untuk memungkinkan server melakukan operasi Git, seperti clone, pull, dan fetch tanpa menggunakan username dan password akun GitHub.

Prosedur ini bertujuan untuk:

  • Mengamankan autentikasi server ke GitHub.

  • Menghindari penggunaan password akun GitHub.

  • Mempermudah proses deployment aplikasi.

  • Memastikan server dapat mengakses repository private maupun public sesuai hak akses yang diberikan.

2. Ruang Lingkup

Prosedur ini berlaku untuk:

  • Ubuntu Server.

  • GitHub repository.

  • Aplikasi berbasis Laravel atau framework lainnya.

  • Server development, staging, maupun production.

3. Persyaratan

Sebelum memulai konfigurasi, pastikan:

  1. Server Ubuntu sudah dapat mengakses internet.

  2. Git sudah terinstal.

  3. Memiliki akun GitHub.

  4. Memiliki akses ke repository yang akan di-clone.

  5. Memiliki akses SSH atau terminal ke server.

Periksa instalasi Git:

git --version

Jika belum terinstal:

sudo apt update
sudo apt install git openssh-client -y

4. Prosedur Konfigurasi SSH Key

4.1. Membuat SSH Key

Login ke server menggunakan user yang akan menjalankan deployment.

Contoh:

ssh dsudana@server

Buat SSH Key menggunakan algoritma Ed25519:

ssh-keygen -t ed25519 -C "dsudana@gmail.com"

Ketika muncul pertanyaan lokasi penyimpanan:

Enter file in which to save the key:

Tekan Enter untuk menggunakan lokasi default:

/home/dsudana/.ssh/id_ed25519

Ketika diminta memasukkan passphrase, isi sesuai kebutuhan keamanan atau tekan Enter jika tidak menggunakan passphrase.

Hasil pembuatan SSH Key terdiri dari:

File

Fungsi

id_ed25519

Private Key

id_ed25519.pub

Public Key

Penting: Private Key tidak boleh dibagikan atau diunggah ke GitHub. Hanya Public Key yang boleh didaftarkan.

4.2. Mengaktifkan SSH Agent

Jalankan:

eval "$(ssh-agent -s)"

Tambahkan private key ke SSH Agent:

ssh-add ~/.ssh/id_ed25519

Periksa key yang sudah terdaftar:

ssh-add -l

4.3. Mengambil Public Key

Tampilkan Public Key:

cat ~/.ssh/id_ed25519.pub

Salin seluruh isi output yang dimulai dengan:

ssh-ed25519 AAAAC3NzaC1lZDI1NTE5...

Pastikan seluruh karakter tersalin dengan benar.

4.4. Mendaftarkan SSH Key ke GitHub

  1. Login ke akun GitHub.

  2. Buka halaman:

    https://github.com/settings/ssh/new

  3. Isi konfigurasi:

    • Title: dsudana-server

    • Key type: Authentication Key

    • Key: Paste Public Key yang sudah disalin.

  4. Klik Add SSH Key.

Setelah berhasil, SSH Key akan terdaftar pada akun GitHub.

5. Pengujian Koneksi GitHub

Jalankan perintah:

ssh -T git@github.com

Pada koneksi pertama, mungkin muncul konfirmasi fingerprint host GitHub.

Periksa fingerprint menggunakan dokumentasi resmi GitHub sebelum menyetujui koneksi.

Jika fingerprint sesuai, ketik:

yes

Jika konfigurasi berhasil, akan muncul pesan:

Hi dsudana! You've successfully authenticated,
but GitHub does not provide shell access.

Pesan tersebut menunjukkan bahwa autentikasi SSH ke GitHub berhasil.

6. Prosedur Clone Repository

Setelah autentikasi berhasil, repository dapat di-clone menggunakan SSH URL.

Contoh repository:

git@github.com:dsudana/hijrahkreativa.git

Masuk ke direktori aplikasi:

cd /opt

Clone repository:

git clone git@github.com:dsudana/hijrahkreativa.git

Jika berhasil, direktori berikut akan terbentuk:

/opt/hijrahkreativa

Periksa isi direktori:

cd /opt/hijrahkreativa
ls -la

7. Pengaturan Permission Direktori

Untuk menghindari masalah permission, proses Git sebaiknya dijalankan menggunakan user pemilik SSH Key.

Hindari menjalankan Git menggunakan sudo, karena SSH Key milik user dsudana tidak otomatis tersedia untuk user root.

Jika direktori aplikasi belum tersedia, buat direktori dengan:

sudo mkdir -p /opt/hijrahkreativa
sudo chown dsudana:dsudana /opt/hijrahkreativa

Kemudian jalankan clone:

git clone git@github.com:dsudana/hijrahkreativa.git /opt/hijrahkreativa

Jika repository sudah terlanjur dibuat oleh root, perbaiki kepemilikannya secara spesifik:

sudo chown -R dsudana:dsudana /opt/hijrahkreativa

Jangan mengubah kepemilikan seluruh direktori /opt tanpa memeriksa aplikasi dan service lain yang berjalan di dalamnya.

8. Prosedur Update Repository

Setelah repository berhasil di-clone, update kode aplikasi dapat dilakukan menggunakan Git Pull.

Masuk ke direktori aplikasi:

cd /opt/hijrahkreativa

Periksa status repository:

git status

Periksa branch aktif:

git branch

Ambil pembaruan dari GitHub:

git pull origin main

Catatan: Sesuaikan nama branch jika repository menggunakan branch selain main.

9. Troubleshooting

9.1. Error: Password Authentication Is Not Supported

Contoh pesan:

remote: Invalid username or token.
Password authentication is not supported for Git operations.

Penyebab:

GitHub tidak lagi mendukung autentikasi password akun untuk operasi Git melalui HTTPS.

Solusi:

Gunakan SSH URL:

git clone git@github.com:dsudana/hijrahkreativa.git

9.2. Error: Permission Denied (Publickey)

Contoh:

git@github.com: Permission denied (publickey).

Penyebab:

  • Public Key belum didaftarkan ke GitHub.

  • SSH Agent belum memuat private key.

  • SSH Key dibuat oleh user yang berbeda.

  • Repository tidak memberikan akses kepada akun pemilik SSH Key.

Solusi:

Periksa key:

ssh-add -l

Jika belum terdaftar:

ssh-add ~/.ssh/id_ed25519

Uji kembali:

ssh -T git@github.com

9.3. Error: Repository Not Found

Contoh:

ERROR: Repository not found.

Penyebab:

  • URL repository salah.

  • Repository private dan akun GitHub tidak memiliki akses.

  • SSH Key terdaftar pada akun GitHub yang berbeda.

Solusi:

Periksa URL repository dan hak akses akun GitHub.

9.4. Error: Could Not Open Directory

Penyebab: User tidak memiliki izin menulis pada direktori tujuan.

Solusi:

sudo chown -R dsudana:dsudana /opt/hijrahkreativa

Pastikan direktori yang diubah kepemilikannya memang hanya direktori aplikasi terkait.

10. Standar Keamanan

Untuk menjaga keamanan server dan repository, terapkan ketentuan berikut:

  1. Jangan membagikan private key kepada pihak lain.

  2. Jangan mengunggah private key ke repository GitHub.

  3. Gunakan user Linux khusus untuk deployment jika memungkinkan.

  4. Hindari menjalankan operasi Git dengan sudo.

  5. Batasi akses SSH server hanya kepada administrator yang berwenang.

  6. Gunakan passphrase untuk private key jika sesuai dengan mekanisme operasional server.

  7. Untuk server production, pertimbangkan penggunaan GitHub Deploy Key dengan akses read-only apabila server hanya perlu mengambil kode dari satu repository.

11. Checklist Verifikasi

Sebelum proses deployment dilanjutkan, pastikan seluruh tahapan berikut sudah selesai.

  • Git terinstal pada Ubuntu Server.

  • SSH Key Ed25519 berhasil dibuat.

  • SSH Agent aktif.

  • Private Key berhasil dimuat ke SSH Agent.

  • Public Key berhasil didaftarkan ke GitHub.

  • Koneksi SSH ke GitHub berhasil.

  • Repository berhasil di-clone.

  • Permission direktori aplikasi sudah sesuai.

  • Git Pull berhasil dijalankan.

12. Referensi Resmi


Dokumen ini menjadi standar prosedur konfigurasi koneksi GitHub pada Ubuntu Server untuk mendukung proses pengelolaan source code dan deployment aplikasi secara aman dan terstruktur.

Bagikan artikel:

Artikel lainnya