92 lines
2.1 KiB
Markdown
92 lines
2.1 KiB
Markdown
## Step 5: Set Up HTTPS with mkcert (Ubuntu/Debian)
|
|
|
|
**1. Install mkcert (if not already installed):**
|
|
```bash
|
|
sudo apt install libnss3-tools
|
|
curl -JLO "https://dl.filippo.io/mkcert/latest?for=linux/amd64"
|
|
chmod +x mkcert-v*-linux-amd64
|
|
sudo mv mkcert-v*-linux-amd64 /usr/local/bin/mkcert
|
|
```
|
|
|
|
**2. Install local certificate authority:**
|
|
```bash
|
|
mkcert -install
|
|
```
|
|
|
|
**3. Create certificates directory:**
|
|
```bash
|
|
mkdir certs
|
|
mkcert -cert-file certs/localhost+2.pem -key-file certs/localhost+2-key.pem localhost 127.0.0.1 ::1
|
|
```
|
|
|
|
This creates:
|
|
• certs/localhost+2.pem (certificate)
|
|
• certs/localhost+2-key.pem (private key)
|
|
|
|
|
|
|
|
**4. Install Uvicorn (ASGI server with SSL support):**
|
|
|
|
Ensure you are at the project root and venv is activated:
|
|
```bash
|
|
pip install uvicorn[standard]
|
|
```
|
|
|
|
**5. Update requirements.txt:**
|
|
```bash
|
|
pip freeze > requirements.txt
|
|
```
|
|
|
|
**6. Create run.sh script (Linux):**
|
|
```bash
|
|
cat > run.sh << 'EOF'
|
|
#!/usr/bin/env bash
|
|
uvicorn backend.asgi:application \
|
|
--host 127.0.0.1 --port 8000 \
|
|
--ssl-keyfile ./certs/localhost+2-key.pem \
|
|
--ssl-certfile ./certs/localhost+2.pem
|
|
EOF
|
|
chmod +x run.sh
|
|
```
|
|
|
|
Note: Replace backend with your project name if different.
|
|
|
|
**7. Create VS Code launch configuration (optional):**
|
|
|
|
For debugging in VS Code, create `.vscode/launch.json`:
|
|
|
|
```bash
|
|
mkdir -p .vscode
|
|
cat > .vscode/launch.json << 'EOF'
|
|
{
|
|
"version": "0.2.0",
|
|
"configurations": [
|
|
{
|
|
"name": "Django HTTPS (Uvicorn)",
|
|
"type": "debugpy",
|
|
"request": "launch",
|
|
"module": "uvicorn",
|
|
"args": [
|
|
"backend.asgi:application",
|
|
"--host", "0.0.0.0",
|
|
"--port", "8000",
|
|
"--ssl-keyfile", "./certs/localhost+2-key.pem",
|
|
"--ssl-certfile", "./certs/localhost+2.pem",
|
|
"--reload"
|
|
],
|
|
"django": true,
|
|
"justMyCode": true,
|
|
"python": "${workspaceFolder}/venv/bin/python"
|
|
}
|
|
]
|
|
}
|
|
EOF
|
|
```
|
|
|
|
This allows you to:
|
|
- Run and debug Django with F5 in VS Code
|
|
- Set breakpoints in your Django code
|
|
- Automatic venv activation via the `python` path
|
|
|
|
Note: Replace `backend` with your project name if different.
|