Update Coolify deployment guide to reflect changes in start commands and clarify Base Directory behavior for backend and frontend services.

Co-authored-by: Copilot <copilot@github.com>
This commit is contained in:
2026-04-27 21:02:42 +02:00
parent 508f0e5d40
commit ae7727c01a
+4 -4
View File
@@ -33,11 +33,11 @@ Coolify's built-in reverse proxy routes traffic:
7. Set **Ports Exposed** to `8000` 7. Set **Ports Exposed** to `8000`
8. Set **Start Command** to: 8. Set **Start Command** to:
```txt ```txt
uvicorn backend.app.main:app --host 0.0.0.0 --port 8000 uvicorn app.main:app --host 0.0.0.0 --port 8000
``` ```
9. Click **Create Resource** 9. Click **Create Resource**
> **Note:** Nixpacks auto-detects Python from `requirements.txt`. No `nixpacks.toml` file is needed. The Base Directory setting is the key configuration — without it, Nixpacks looks at the repository root and won't find the Python project. > **Important:** Nixpacks copies the **contents** of the Base Directory to `/app/` in the container. When Base Directory is `/backend`, the `backend/` folder wrapper is removed — only `app/`, `tests/`, and `requirements.txt` are copied. Therefore the start command uses `app.main:app` (not `backend.app.main:app`).
### Backend Environment Variables ### Backend Environment Variables
@@ -61,11 +61,11 @@ Add these as **Runtime** environment variables in Coolify:
6. Set **Ports Exposed** to `5000` 6. Set **Ports Exposed** to `5000`
7. Set **Start Command** to: 7. Set **Start Command** to:
```txt ```txt
gunicorn frontend.app.main:app --bind 0.0.0.0:5000 --workers 2 --timeout 120 gunicorn app.main:app --bind 0.0.0.0:5000 --workers 2 --timeout 120
``` ```
8. Click **Create Resource** 8. Click **Create Resource**
> **Note:** Nixpacks auto-detects Python from `requirements.txt`. No `nixpacks.toml` file is needed. The Base Directory setting is the key configuration — without it, Nixpacks looks at the repository root and won't find the Python project. > **Important:** Nixpacks copies the **contents** of the Base Directory to `/app/` in the container. When Base Directory is `/frontend`, the `frontend/` folder wrapper is removed — only `app/`, `tests/`, and `requirements.txt` are copied. Therefore the start command uses `app.main:app` (not `frontend.app.main:app`).
### Frontend Environment Variables ### Frontend Environment Variables