Untuk memulai development aplikasi dengan Django, berikut langkah-langkahnya

1. Cek system requirements

Sebelum menginstall Django, kamu perlu tau versi Django berapa yang akan digunakan dan versi Python berapa yang dibutuhkan untuk menjalankan versi Django tersebut. Saat artikel ini ditulis, saya menyarankan Django 5.2 (LTS) untuk digunakan. Dan Django 5.2 membutuhkan versi Python 3.10 atau lebih tinggi.

cek versi Python dengan perintah:

$ python --version

contoh outputnya:

Python 3.12.3

Jika versi Python sudah memenuhi syarat, lanjut ke langkah ke-2. Namun jika kamu butuh install versi Python lain, bisa mengikuti langkah di artikel ini http://riespratama.com/install-multi-version-python

2. Membuat virtual environment

Banyak pilihan virtual environment yang bisa digunakan, saya akan mencontohkan dengan environment favorit saya yaitu pipenv. Jika belum punya pipenv, maka bisa diinstall dengan perintah berikut:

$ sudo apt install pipenv

Buat direktori baru untuk development, misal namanya django_project, dan masuk ke dalam direktori tersebut

$ mkdir django_project && cd django_project
~/django_project$

Kemudian gunakan perintah berikut untuk membuat dan mengaktifkan virtual environment

~/django_project$ pipenv shell

contoh outputnya:

Creating a virtualenv for this project...
Pipfile: /home/aries/django_project/Pipfile
Using default python from /usr/bin/python3 (3.12.3) to create virtualenv...
⠙ Creating virtual environment...created virtual environment CPython3.12.3.final.0-64 in 99ms
creator CPython3Posix(dest=/home/aries/.local/share/virtualenvs/django_project-oV2LJRX1, clear=False, no_vcs_ignore=False, global=False)
seeder FromAppData(download=False, pip=bundle, via=copy, app_data_dir=/home/aries/.local/share/virtualenv)
added seed packages: pip==24.0
activators BashActivator,CShellActivator,FishActivator,NushellActivator,PowerShellActivator,PythonActivator

✔ Successfully created virtual environment!
Virtualenv location: /home/aries/.local/share/virtualenvs/django_project-oV2LJRX1
Creating a Pipfile for this project...
Launching subshell in virtual environment...
aries@stardust:~/django_project$ . /home/aries/.local/share/virtualenvs/django_project-oV2LJRX1/bin/activate
(django_project) aries@stardust:~/django_project$

Perhatikan ada (django_project) di awal prompt, menandakan virtual environment sudah aktif. Untuk keluar dari virtual environment, kita bisa menggunakan perintah exit atau tekan ctrl+D, dan masuk kembali menggunakan pienv shell.

3. Install Django

Pastikan kita sudah berada di dalam virtual environment (django_project), gunakan perintah berikut untuk menginstall Django dengan menyertakan versinya:

(django_project) $ pipenv install django==5.2

Contoh output:

Installing django==5.2...
Resolving django==5.2...
Added django to Pipfile's [packages] ...
✔ Installation Succeeded
Pipfile.lock not found, creating...
Locking [packages] dependencies...
Building requirements...
Resolving dependencies...
✔ Success!
Locking [dev-packages] dependencies...
Updated Pipfile.lock (f9c53500a48e2a36a435d6acbcbe7f1347232f6cc99989c11ba4af824e066db2)!
Installing dependencies from Pipfile.lock (066db2)...

4. Buat project baru

Buat project baru dengan Django, misalkan namanya wms:

(django_project) $ django-admin startproject wms_project .

Perhatikan nama project-nya, saya menggunakna wms_project untuk menandakan direktori project yang digunakan, dan membedakan dengan direktori aplikasi nantinya, perhatikan juga titik di akhir perintah, jika tanpa titik, direktori project akan dibuat di dalam direktori lagi, gambarannya sebagai berikut

5. Tes jalankan aplikasi di local server

Jika startproject sudah berhasil, maka kita bisa mengetes jalannya Django yang sudah kita install dengan perintah berikut

(django_project) $ python manage.py runserver

contoh output:

Watching for file changes with StatReloader
Performing system checks...

System check identified no issues (0 silenced).

You have 18 unapplied migration(s). Your project may not work properly until you apply the migrations for app(s): admin, auth, contenttypes, sessions.
Run 'python manage.py migrate' to apply them.
July 02, 2025 - 09:28:05
Django version 5.2, using settings 'wms_project.settings'
Starting development server at http://127.0.0.1:8000/
Quit the server with CONTROL-C.

WARNING: This is a development server. Do not use it in a production setting. Use a production WSGI or ASGI server instead.
For more information on production servers see: https://docs.djangoproject.com/en/5.2/howto/deployment/
[02/Jul/2025 09:28:20] "GET / HTTP/1.1" 200 12068
Not Found: /favicon.ico
[02/Jul/2025 09:28:20] "GET /favicon.ico HTTP/1.1" 404 2213

Jika muncul output seperti di atas, tinggal arahkan browser ke http://127.0.0.1:8000/ atau http://localhost:8000/ dan lihat halaman demo Django ditampilkan

Itulah 5 langkah setup awal Django, dan selanjutnya adalah konfigurasi dan membuat aplikasi di postingan selanjutnya.