Panduan Membuat Private Docker Registry di Server

Buat DomaiNesians yang ingin menyimpan dan mengelola image Docker secara privat di server Ubuntu, membuat private Docker Registry bisa jadi pilihan yang tepat. Dengan mempunyai registry sendiri, distribusi image aplikasi jadi lebih terkontrol tanpa harus bergantung pada layanan publik. Di panduan ini, kamu akan diajak langkah demi langkah untuk men-setup private Docker Registry di Ubuntu, dengan cara yang simpel, aman, dan praktis untuk kebutuhan deploy harian.

Panduan Membuat Private Docker Registry di Server
sumber: medium.com

Apa Itu Private Docker Registry?

Private Docker Registry adalah solusi penyimpanan image Docker yang kamu jalankan sendiri di server, baik itu lokal maupun berbasis cloud. Dengan sistem ini, kamu bisa simpan dan bagikan image ke tim atau sistem internal tanpa harus lewat layanan publik seperti Docker Hub cocok buat yang butuh privasi dan kontrol penuh.

Selain lebih aman, registry ini juga bantu mempercepat workflow, apalagi saat project kamu butuh deploy berkala atau dijalankan bareng tim. Kamu bisa menentukan siapa saja yang punya izin akses, tanpa khawatir batas kuota, sehingga distribusi image berjalan lebih lancar dan cepat. Cocok banget buat setup yang butuh kestabilan dan fleksibilitas tinggi.

Persiapan Server Ubuntu

Sebelum masuk ke tahap instalasi private Docker registry, pastikan server Ubuntu kamu udah siap. Beberapa hal dasar perlu disiapkan dulu biar proses setup-nya jalan mulus tanpa hambatan. Ini dia hal-hal penting yang perlu kamu cek:

• Pastikan server Ubuntu kamu sudah terinstal dan update ke versi terbaru
• Pastikan kamu punya akses root atau user dengan hak sudo.
• Cek dulu apakah Docker udah terinstal dan bisa jalan tanpa error di server kamu.
• Pastikan koneksi internet server stabil, soalnya nanti bakal dipakai buat download image dan paket yang dibutuhin.
• Siapkan ruang penyimpanan yang cukup untuk menyimpan image Docker nantinya.
• Jangan lupa atur firewall supaya port yang dipakai registry, biasanya port 5000, bisa diakses dengan lancar.

Instalasi Docker Registry

Untuk mulai membuat private Docker Registry di server Ubuntu, kamu perlu menjalankan container registry resmi dari Docker. Berikut langkah-langkahnya:

1. Install Registry

Gunakan perintah ini untuk menjalankan registry Docker resmi sebagai container di port 5000:

Cek apakah container registry sudah berjalan dengan perintah:

2. Push Image

Kalau semuanya sudah siap, kamu bisa mulai upload image ke registry dengan menandainya sesuai alamat server. Contohnya seperti ini:

Untuk akses dari device lain, ganti localhost dengan IP atau domain server kamu.

3. Konfigurasi Storage 

Buat folder khusus di server Ubuntu untuk menyimpan data registry, misalnya /var/lib/registry. Contoh perintah untuk menjalankan registry dengan penyimpanan yang tahan lama (persistent storage):

Dengan cara ini, data image yang kamu simpan di registry akan tetap aman walau container di-restart atau dihapus

4. Install SSL

Siapkan sertifikat SSL valid, bisa dari Let’s Encrypt atau sertifikat yang kamu punya. Buat kamu yang mau jalanin registry pakai SSL, kamu bisa langsung start container-nya pakai command seperti di bawah ini:

Pastikan port 5000 sudah dibuka di firewall, dan akses ke registry dari client dilakukan lewat protokol HTTPS.

Testing Private Docker Registry

Sebelum mulai menggunakan Private Docker Registry, penting untuk mengujinya terlebih dahulu. Di sini, kita akan melakukan beberapa tes untuk memastikan registry dapat berfungsi dengan benar.

1. Login ke Registry

Coba login dari mesin client dengan perintah:

2. Push Image ke Registry

Tag image yang mau kamu simpan, lalu push ke registry:

3. Pull Image dari Registry

Coba pull image yang sudah kamu push tadi:

4. Cek di Server

Pastikan image sudah tersimpan di folder storage yang kamu pakai untuk registry.

Troubleshooting Umum

Kalau kamu menemukan masalah saat setup atau pakai private Docker Registry, beberapa tips troubleshooting ini bisa membantu:

1. Registry tidak bisa diakses

Pastikan container registry sedang berjalan dengan perintah docker ps. Cek firewall dan pastikan port 5000 terbuka dan akses alamat dengan port tersebut.

2. Gagal Push atau Pull Image

Cek apakah kamu sudah login ke registry dengan benar menggunakan docker login. Cek image sudah ditag sesuai alamat registry, jika pakai SSL pastikan sertifikat valid dan client menerima sertifikat tersebut.

3. Data registry hilang setelah restart container

Pastikan kamu sudah memasang volume atau folder penyimpanan registry secara permanen, dan periksa izin akses (permission) folder tersebut di server.

4. Masalah Autentikasi

Pastikan konfigurasi username & password sudah benar. Cek konfigurasi auth jika pakai basic auth. Jika masalah masih berlanjut, coba cek log error registry dengan:

Tips ini biasanya cukup membantu menemukan dan memperbaiki kendala saat menjalankan private Docker Registry.

Keuntungan Menggunakan Private Docker Registry

Buat registry di server memang butuh effort di awal, tapi manfaatnya bakal terasa dalam jangka panjang, apalagi kalau sering handle banyak image. Berikut keuntungan yang akan kamu peroleh:

1. Kontrol Penuh atas Image
   Kamu tidak perlu lagi bergantung ke Docker Hub atau layanan eksternal. Semua image bisa kamu simpan, kelola, dan akses langsung dari server sendiri.
2. Keamanan Lebih Terjaga
   Dengan dukungan SSL dan autentikasi, kamu bisa batasi siapa saja yang boleh push atau pull image, jadi risiko kebocoran data jadi lebih kecil.
3. Transfer Lebih Cepat
   Karena image disimpan di jaringan lokal atau server sendiri, proses push dan pull bisa jauh lebih cepat dibanding akses ke registry publik.
4. Hemat Biaya Jangka Panjang
   Gak perlu bayar fitur premium atau takut kuota habis. Dengan VPS pribadi, kamu bebas menggunakan registry tanpa batasan.
5. Mudah Diintegrasikan ke CI/CD
   Private registry bisa jadi bagian penting dalam pipeline otomatisasi, dari build sampai deployment, tanpa harus keluar dari ekosistem sendiri.

Solusi Sederhana untuk Proyek Lebih Aman

Membangun private Docker Registry di server Ubuntu bukan hanya membuat pengelolaan image jadi lebih terorganisir, tapi juga meningkatkan keamanan dan efisiensi, terutama untuk tim atau proyek dengan skala besar. Dengan setup yang tepat dari storage, SSL, hingga autentikasi DomaiNesians bisa punya ekosistem container sendiri tanpa tergantung layanan publik.

Kalau kamu butuh infrastruktur yang stabil dan siap dipakai buat registry, pastikan pakai VPS yang cepat, uptime tinggi, dan aman. Di Cloud VPS DomaiNesia, kamu bisa dapatkan semua itu dengan harga yang tetap terjangkau. Yuk, mulai bangun workflow container kamu sendiri sekarang juga!