Panduan Lengkap Cara Install Hugo di Windows, macOS, dan Linux untuk Pemula 2026
Panduan Lengkap Cara Install Hugo di Windows, macOS, dan Linux untuk Pemula 2026
Hugo merupakan salah satu static site generator paling populer di kalangan pengembang website modern. Kecepatan build yang luar biasa, fleksibilitas dalam templating, dan ekosistem yang matang menjadikan Hugo pilihan utama untuk membangun blog, dokumentasi, portfolio, hingga website perusahaan. Dalam panduan ini, kita akan membahas secara komprehensif cara install Hugo di berbagai sistem operasi mulai dari Windows, macOS, hingga Linux. Panduan ini dirancang untuk pemula yang baru mengenal Hugo namun juga berguna bagi pengembang yang ingin memperdalam pemahaman mereka tentang instalasi dan konfigurasi Hugo.
Sebelum kita memulai proses instalasi, penting untuk memahami apa yang membuat Hugo istimewa dibandingkan static site generator lainnya. Hugo dibangun dengan bahasa Go yang terkenal dengan kecepatan kompilasinya. Berbeda dengan generator lain yang memerlukan waktu build cukup lama untuk situs berskala besar, Hugo mampu membangun ribuan halaman dalam hitungan detik. Fitur live reload yang responsif juga membuat pengalaman pengembangan menjadi sangat smooth. Selain itu, Hugo memiliki sistem templating yang powerful dengan Go templates, memungkinkan pengembang untuk membuat tampilan yang kompleks dengan kode yang bersih dan maintainable.
Persyaratan Sistem untuk Instalasi Hugo
Sebelum melakukan instalasi Hugo, pastikan sistem Anda memenuhi persyaratan minimum yang diperlukan. Hugo tidak memerlukan spesifikasi tinggi untuk dijalankan, namun ada beberapa hal yang perlu diperhatikan agar pengalaman pengembangan optimal. Untuk sistem operasi, Hugo mendukung Windows 10 atau versi lebih baru, macOS 10.15 (Catalina) atau versi lebih baru, dan distribusi Linux modern seperti Ubuntu 20.04+, Debian 11+, atau Fedora 35+. Dari sisi hardware, minimal diperlukan prosesor dengan arsitektur 64-bit, RAM 4GB (disarankan 8GB untuk proyek besar), dan penyimpanan minimal 500MB untuk instalasi Hugo beserta proyek Anda.
Selain persyaratan dasar di atas, ada beberapa komponen tambahan yang sangat disarankan untuk diinstal bersama Hugo. Git diperlukan untuk manajemen versi dan penggunaan tema-tema dari repository publik. Akses ke terminal atau command line juga wajib dimiliki karena Hugo primarily dioperasikan melalui command line interface. Untuk pengembangan yang lebih advanced, pemahaman dasar tentang command line akan sangat membantu dalam memaksimalkan kemampuan Hugo. Beberapa IDE atau text editor yang direkomendasikan meliputi Visual Studio Code dengan ekstensi Hugo, GoLand, atau bahkan Vim dengan plugin yang tepat untuk syntax highlighting Hugo templates.
Cara Install Hugo di Windows
Instalasi Hugo di sistem operasi Windows dapat dilakukan melalui beberapa metode. Metode yang paling direkomendasikan adalah menggunakan package manager seperti Chocolatey atau Scoop karena memudahkan proses update dan uninstall di kemudian hari. Namun, bagi Anda yang preferensi instalasi manual, Hugo juga menyediakan installer binary yang dapat diunduh langsung dari website resmi mereka.
Metode Instalasi dengan Chocolatey
Chocolatey adalah package manager populer untuk Windows yang memudahkan instalasi dan pengelolaan software. Jika Anda belum memiliki Chocolatey, kunjungi website chocolatey.org dan ikuti instruksi instalasi yang disediakan. Setelah Chocolatey terinstal, buka PowerShell dengan hak administrator dan jalankan perintah berikut untuk menginstal Hugo:
choco install hugo-extended -y
Perintah di atas akan menginstal Hugo Extended yang mendukung semua fitur Hugo termasuk pemrosesan Sass/SCSS. Setelah instalasi selesai, verifikasi keberhasilan instalasi dengan menjalankan:
hugo version
Jika instalasi berhasil, Anda akan melihat informasi versi Hugo yang terinstal. Untuk memastikan Hugo Extended terinstal dengan benar (yang mendukung asset pipeline lengkap), periksa output yang menunjukkan “extended” pada nama versi. Proses instalasi dengan Chocolatey ini juga otomatis menambahkan Hugo ke PATH sistem sehingga dapat diakses dari anywhere di command line.
Metode Instalasi dengan Scoop
Scoop merupakan alternatif package manager lain yang populer di kalangan developer Windows. Jika Anda lebih prefer menggunakan Scoop, pastikan Scoop sudah terinstal di sistem Anda. Buka PowerShell dan jalankan perintah berikut untuk menginstal Hugo:
scoop install hugo-extended
Scoop memiliki keunggulan dalam hal isolasi instalasi yang lebih baik dan tidak memerlukan hak administrator untuk instalasi software. Sama seperti Chocolatey, Scoop juga akan otomatis menambahkan Hugo ke PATH sistem. Untuk memperbarui Hugo ke versi terbaru, cukup jalankan:
scoop update hugo
Metode Instalasi Manual
Bagi Anda yang menginginkan kontrol penuh atas proses instalasi atau berada dalam lingkungan dengan keterbatasan akses internet, metode instalasi manual dengan binary download adalah pilihan yang tepat. Kunjungi halaman release resmi Hugo di github.com/gohugoio/hugo/releases dan unduh versi Hugo Extended untuk Windows (file dengan ekstensi .zip). Ekstrak file zip yang telah diunduh ke lokasi yang Anda inginkan, misalnya C:\Hugo. Setelah itu, tambahkan folder Hugo ke PATH sistem dengan langkah-langkah berikut: Buka System Properties, klik Environment Variables, pada bagian System variables cari Path dan klik Edit, kemudian tambahkan path lengkap ke folder Hugo (misalnya C:\Hugo\bin). Buka command prompt baru dan verifikasi instalasi dengan hugo version.
Cara Install Hugo di macOS
Pengguna macOS memiliki beberapa opsi untuk menginstal Hugo. Package manager Homebrew adalah metode yang paling populer dan direkomendasikan karena kemudahan pengelolaan dan update. Bagi pengguna yang sudah familiar dengan Homebrew, proses instalasi Hugo menjadi sangat straightforward dan terintegrasi dengan ekosistem package manager macOS.
Instalasi dengan Homebrew
Homebrew adalah package manager standar untuk macOS yang digunakan oleh mayoritas developer. Jika Homebrew belum terinstal di sistem Anda, instal terlebih dahulu dengan menjalankan perintah berikut di Terminal:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
Setelah Homebrew terinstal, instal Hugo Extended dengan perintah:
brew install hugo
Perintah ini akan mengunduh dan menginstal Hugo beserta semua dependensinya secara otomatis. Untuk memastikan Hugo Extended terinstal (yang mendukung Sass/SCSS), verifikasi dengan menjalankan:
hugo version
Output yang benar akan menampilkan informasi versi dengan kata “extended” di dalamnya. Untuk memperbarui Hugo ke versi terbaru di kemudian hari, cukup jalankan:
brew upgrade hugo
Homebrew juga memudahkan pengelolaan versi berbeda Hugo jika diperlukan untuk kompatibilitas proyek tertentu. Anda dapat menginstal versi spesifik Hugo dengan perintah brew install hugo@<versi> jika diperlukan.
Instalasi dengan MacPorts
Bagi pengguna yang lebih familiar dengan MacPorts, Hugo juga tersedia melalui package manager ini. Jalankan perintah berikut di Terminal:
sudo port install hugo
Proses ini memerlukan password administrator dan akan menginstal Hugo beserta dependensinya. Meskipun Homebrew lebih populer di kalangan developer modern, MacPorts tetap menjadi opsi yang valid terutama bagi pengguna yang sudah memiliki ekosistem MacPorts yang mapan.
Cara Install Hugo di Linux
Instalasi Hugo di Linux bervariasi tergantung distribusi yang digunakan. Ubuntu/Debian dan Fedora/RHEL/CentOS memiliki package manager masing-masing yang dapat digunakan untuk instalasi Hugo. Selain itu, instalasi melalui Go modules juga menjadi opsi bagi pengguna yang menginginkan versi terbaru atau ingin berkontribusi pada pengembangan Hugo.
Instalasi di Ubuntu dan Debian
Pada distribusi Ubuntu dan Debian, Hugo tersedia di repository resmi namun versinya mungkin tidak selalu yang terbaru. Untuk mendapatkan versi terbaru, disarankan untuk menginstal dari repository GitHub atau menggunakan Snap. Metode yang direkomendasikan adalah sebagai berikut:
Pertama, unduh package Hugo Extended terbaru dari halaman release GitHub. Untuk Ubuntu 64-bit, unduh file dengan ekstensi .deb. Setelah terunduh, instal dengan package manager dpkg:
wget https://github.com/gohugoio/hugo/releases/download/v0.139.2/hugo_extended_0.139.2_linux-amd64.deb
sudo dpkg -i hugo_extended_0.139.2_linux-amd64.deb
Jika terjadi masalah dependensi, jalankan sudo apt-get install -f untuk memperbaiki dependensi yang hilang. Alternatif lain adalah menggunakan Snap:
sudo snap install hugo --channel=extended
Snap menawarkan keunggulan dalam hal update otomatis dan isolasi yang lebih baik. Pastikan sistem Anda mendukung Snap sebelum menggunakan metode ini.
Instalasi di Fedora, RHEL, dan CentOS
Pengguna Fedora dapat menginstal Hugo langsung dari repository default dengan dnf:
sudo dnf install hugo
Untuk RHEL dan CentOS, Anda mungkin perlu mengaktifkan EPEL repository terlebih dahulu:
sudo dnf install epel-release
sudo dnf install hugo
Atau unduh package RPM langsung dari GitHub dan instal dengan dnf atau yum:
wget https://github.com/gohugoio/hugo/releases/download/v0.139.2/hugo_extended_0.139.2_linux-amd64.rpm
sudo dnf localinstall hugo_extended_0.139.2_linux-amd64.rpm
Instalasi dari Source dengan Go
Bagi developer yang ingin menginstal Hugo dari source atau berkontribusi pada pengembangan Hugo, instalasi dari Go modules adalah pilihan yang tepat. Pastikan Go sudah terinstal di sistem Anda dengan versi minimal Go 1.20. Jika Go belum terinstal, ikuti panduan instalasi Go dari website resmi golang.org. Setelah Go tersedia, jalankan perintah berikut:
go install github.com/gohugoio/hugo@latest
Perintah ini akan mengunduh dan mengkompilasi Hugo dari source, kemudian menempatkannya di direktori $GOPATH/bin. Pastikan $GOPATH/bin sudah ditambahkan ke PATH sistem agar Hugo dapat diakses dari command line.
Membuat Proyek Hugo Pertama
Setelah Hugo berhasil terinstal, langkah selanjutnya adalah membuat proyek pertama Anda. Proses ini sangat mudah dengan command line interface Hugo yang intuitif. Buka terminal atau command prompt dan navigasi ke direktori tempat Anda ingin membuat proyek Hugo baru. Jalankan perintah berikut untuk membuat situs baru:
hugo new site nama-proyek-anda
Hugo akan membuat struktur direktori lengkap untuk proyek baru Anda. Struktur ini mencakup direktori untuk content, layouts, static files, dan konfigurasi. Setelah situs berhasil dibuat, masuk ke direktori proyek dengan cd nama-proyek-anda dan jalankan server development untuk melihat situs Anda:
hugo server -D
Flag -D memungkinkan Anda melihat halaman draft yang sedang dalam pengembangan. Server development Hugo akan berjalan di http://localhost:1313 dengan fitur live reload yang akan otomatis menyegarkan halaman saat Anda mengubah file. Anda sekarang siap untuk mulai mengembangkan website dengan Hugo!
Verifikasi dan Troubleshooting Instalasi
Setelah instalasi selesai, penting untuk memverifikasi bahwa Hugo terinstal dengan benar dan semua fitur berfungsi sebagaimana mestinya. Beberapa masalah umum yang mungkin dihadapi beserta solusinya perlu dipahami untuk pengalaman pengembangan yang lancar.
Masalah pertama yang sering terjadi adalah Hugo tidak dikenali di command line setelah instalasi. Ini biasanya disebabkan oleh PATH sistem yang belum diperbarui. Solusinya adalah menutup dan membuka kembali terminal, atau manually menambahkan path Hugo ke PATH sesuai sistem operasi yang digunakan. Verifikasi dengan menjalankan echo $PATH di Linux/macOS atau echo %PATH% di Windows untuk memastikan path Hugo tercantum dalam daftar.
Masalah kedua adalah error “command not found” yang biasanya terjadi saat binary Hugo tidak berada di direktori yang benar atau memiliki permission yang salah. Di Linux dan macOS, pastikan file Hugo executable memiliki permission eksekusi dengan menjalankan chmod +x /path/to/hugo. Di Windows, pastikan Anda menjalankan command prompt sebagai administrator saat melakukan instalasi manual.
Masalah ketiga adalah fitur Sass/SCSS tidak berfungsi. Ini mengindikasikan bahwa Anda mungkin telah menginstal Hugo regular alih-alih Hugo Extended. Hugo Extended diperlukan untuk memproses stylesheet Sass/SCSS. Periksa versi Hugo dengan hugo version dan pastikan output mencakup kata “extended”. Jika tidak, uninstall dan instal ulang dengan package Hugo Extended.
Kesimpulan
Instalasi Hugo di berbagai sistem operasi sebenarnya cukup straightforward jika mengikuti langkah-langkah yang tepat. Untuk pengguna Windows, Chocolatey atau Scoop adalah pilihan terbaik karena kemudahan pengelolaan. Pengguna macOS dapat memanfaatkan Homebrew untuk instalasi yang terintegrasi dengan ekosistem package manager mereka. Sementara pengguna Linux memiliki fleksibilitas untuk memilih antara package manager distribusi masing-masing atau instalasi manual dari binary.
Setelah Hugo berhasil terinstal, Anda perjalanan membangun website statis yang cepat, siap untuk memulai aman, dan mudah dikelola. Dengan mengikuti panduan ini, Anda telah memiliki fondasi yang kuat untuk mengeksplorasi fitur-fitur lebih lanjut Hugo seperti templating, shortcodes, dan deployment ke berbagai platform hosting.
Artikel Terkait
Link Postingan : https://www.tirinfo.com/cara-install-hugo-windows-mac-linux/