we have a freshly installed qfieldcloud and we tried uploading a project with qgis but we getting unknown errors..
some short infos about our setup:
Debian 13 installed with git (latest) runs as docker behind a apache proxy
environment: Production/Standalone
in the logs u can see a request on follwing URL:
QFIELDCLOUD_WORKER_QFIELDCLOUD_URL=http://app:8000/api/v1/
may thats the Problem but i can not figure it out cause im a docker noob.. 
we get following erros:
at the qfielcloud web app at jobs:
Error type: API_INTERNAL_SERVER_ERROR
Type: Process QGIS Project File
Output pre:
::<<<::d67beb8b-e810-4330-ab21-f011bc47e262 Start QGIS Application
08:25:02.998 root INFO Available user defined environment variables: []
08:25:02.998 root INFO Starting QGIS app version 34410 (565fe70bd9e)...
08:25:03.237 root INFO QGIS app started!
::>>>::d67beb8b-e810-4330-ab21-f011bc47e262 2
::<<<::45375bbe-519f-4562-84b5-02f6d806216e Download Project Directory
08:25:03.240 root INFO Preparing a temporary directory for project files…
08:25:03.240 root INFO Downloading project files to /tmp/tmpvnztqg83/files…
08:25:03.280 root INFO Downloading project files…
08:25:03.321 /usr/local/lib/python3.12/dist-packages/qfieldcloud_sdk/sdk.py INFO GET http://app:8000/api/v1/files/dd50f218-1f08-429a-8bbd-62a467817115/QField_Cloud_Test.gpkg/ got HTTP 500
::>>>::45375bbe-519f-4562-84b5-02f6d806216e 1
08:25:03.355 root INFO Stopping QGIS app…
08:25:03.408 root INFO Deleted QGIS app!
Feedback Pre:
{
"container_exit_code": 0,
"error": "Requested \"http://app:8000/api/v1/files/dd50f218-1f08-429a-8bbd-62a467817115/QField_Cloud_Test.gpkg/\" and got \"500 Internal Server Error\":\n{\n \"code\": \"unknown_error\",\n \"message\": \"QFieldcloud Unknown Error\"\n}",
"error_class": "QfcRequestException",
"error_origin": "container",
"error_stack": "Traceback (most recent call last):\n File \"/usr/local/lib/python3.12/dist-packages/qfieldcloud_sdk/sdk.py\", line 1976, in _request\n response.raise_for_status()\n File \"/usr/local/lib/python3.12/dist-packages/requests/models.py\", line 1028, in raise_for_status\n raise HTTPError(http_error_msg, response=self)\nrequests.exceptions.HTTPError: 500 Server Error: Internal Server Error for url: http://app:8000/api/v1/files/dd50f218-1f08-429a-8bbd-62a467817115/QField_Cloud_Test.gpkg/\n\nThe above exception was the direct cause of the following exception:\n\nTraceback (most recent call last):\n File \"/usr/src/app/qfc_worker/workflow.py\", line 261, in run_workflow\n return_values = step.method(**arguments)\n ^^^^^^^^^^^^^^^^^^^^^^^^\n File \"/usr/src/app/qfc_worker/utils.py\", line 440, in download_project\n client.download_files(\n File \"/usr/local/lib/python3.12/dist-packages/qfieldcloud_sdk/sdk.py\", line 1267, in download_files\n raise err\n File \"/usr/local/lib/python3.12/dist-packages/qfieldcloud_sdk/sdk.py\", line 1247, in download_files\n self.download_file(\n File \"/usr/local/lib/python3.12/dist-packages/qfieldcloud_sdk/sdk.py\", line 1334, in download_file\n resp = self._request(\"GET\", url, stream=True, headers=headers)\n ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n File \"/usr/local/lib/python3.12/dist-packages/qfieldcloud_sdk/sdk.py\", line 1978, in _request\n raise QfcRequestException(response) from err\nqfieldcloud_sdk.interfaces.QfcRequestException: Requested \"http://app:8000/api/v1/files/dd50f218-1f08-429a-8bbd-62a467817115/QField_Cloud_Test.gpkg/\" and got \"500 Internal Server Error\":\n{\n \"code\": \"unknown_error\",\n \"message\": \"QFieldcloud Unknown Error\"\n}\n",
"error_type": "API_INTERNAL_SERVER_ERROR",
"feedback_version": "2.0",
"outputs": {
"start_qgis_app": {}
},
"steps": [
{
"id": "start_qgis_app",
"name": "Start QGIS Application",
"returns": {
"qgis_version": "3.44.10-Solothurn"
},
"stage": 2
},
{
"id": "download_project_directory",
"name": "Download Project Directory",
"returns": {},
"stage": 1
},
{
"id": "project_validity_check",
"name": "Project Validity Check",
"returns": {},
"stage": 0
},
{
"id": "opening_check",
"name": "Opening Check",
"returns": {},
"stage": 0
},
{
"id": "project_details",
"name": "Project Details",
"returns": {},
"stage": 0
},
{
"id": "generate_thumbnail_image",
"name": "Generate Thumbnail Image",
"returns": {},
"stage": 0
},
{
"id": "upload_thumbnail",
"name": "Upload Thumbnail Image",
"returns": {},
"stage": 0
},
{
"id": "stop_qgis_app",
"name": "Stop QGIS Application",
"returns": {},
"stage": 0
}
],
"workflow_id": "process_projectfile",
"workflow_name": "Process Projectfile",
"workflow_version": "2.0"
}
Docker Logs:
app-1 | {“request_id”:“none”,“ts”:“2026-08-06T08:25:03.319019+00:00”,“level”:“ERROR”,“name”:“root”,“message”:“Expected to either run behind nginx proxy, debug mode or within a test suite.”,“filename”:“rest_utils.py”,“lineno”:46,“thread”:140585965823680,“source”:“app”,“exc_info”:“Traceback (most recent call last):\n File “/usr/local/lib/python3.14/site-packages/rest_framework/views.py”, line 512, in dispatch\n response = handler(request, *args, **kwargs)\n File “/usr/src/app/qfieldcloud/filestorage/views.py”, line 133, in get\n return download_project_file_version(\n request,\n …<2 lines>…\n file_type=File.FileType.PROJECT_FILE,\n )\n File “/usr/src/app/qfieldcloud/filestorage/view_helpers.py”, line 232, in download_project_file_version\n return download_field_file(\n request,\n …<2 lines>…\n as_attachment,\n )\n File “/usr/src/app/qfieldcloud/filestorage/view_helpers.py”, line 342, in download_field_file\n raise Exception(\n “Expected to either run behind nginx proxy, debug mode or within a test suite.”\n )\nException: Expected to either run behind nginx proxy, debug mode or within a test suite.”}
app-1 | {“status_code”:500,“request”:“<WSGIRequest: GET ‘/api/v1/files/dd50f218-1f08-429a-8bbd-62a467817115/QField_Cloud_Test.gpkg/’>”,“request_id”:“none”,“ts”:“2026-08-06T08:25:03.320623+00:00”,“level”:“ERROR”,“name”:“django.request”,“message”:“Internal Server Error: /api/v1/files/dd50f218-1f08-429a-8bbd-62a467817115/QField_Cloud_Test.gpkg/”,“filename”:“log.py”,“lineno”:253,“thread”:140585965823680,“source”:“app”}