[{"_1":2,"_168":-5,"_169":-5},"loaderData",{"_3":4,"_18":19,"_25":26,"_146":147},"root",{"_5":-5,"_6":-7,"_7":8,"_9":-7,"_10":11,"_12":-7,"_13":14,"_15":16,"_17":11},"currentUser","primaryEmail","siteVerification","6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI","toast","enableDev",false,"incidentStatus","theme","system","contrast","normal","dockerRebrandTour","routes/_layout",{"_20":-5,"_21":22,"_23":11,"_24":22},"username","isAskGordonEnabled",true,"showMinimalLanding","showHoneypotTrap","routes/_layout.r.$namespace.$reponame",{"_27":28,"_29":-5,"_30":11,"_31":11,"_32":33,"_34":35,"_36":-5,"_37":11,"_38":39,"_92":-5,"_93":94,"_134":-5,"_135":11,"_136":22,"_137":11,"_138":11,"_139":-5,"_140":11,"_141":-5,"_142":143,"_144":95,"_145":-7},"canonicalUrl","https://hub.docker.com/r/samexit/qfieldcloud-app-arm64/tags","mcpServer","canSeeDockerfile","canSeeAutobuilds","namespace","samexit","reponame","qfieldcloud-app-arm64","cloudBuildSource","isAutobuildsAvailable","repo",{"_40":41,"_47":48,"_50":51,"_52":53,"_54":11,"_55":56,"_57":58,"_59":60,"_43":35,"_32":33,"_62":63,"_64":49,"_65":66,"_67":68,"_69":70,"_71":-5,"_72":66,"_73":74,"_75":11,"_76":33,"_77":78,"_83":11,"_84":85,"_89":33,"_90":91},"categories",[42],{"_43":44,"_45":46},"name","Developer tools","slug","developer-tools","content_types",[49],"image","date_registered","2026-02-20T19:28:47.714382Z","description","QFieldCloud App ARM64. Patched & optimized for Raspberry Pi 4/5. Ready for standalone hosting.","is_private","last_updated","2026-02-22T17:45:20.762747Z","last_modified","2026-02-23T18:22:09.184306Z","media_types",[61],"application/vnd.docker.container.image.v1+json","pull_count",45134,"repository_type","star_count",0,"status",1,"status_description","active","source","collaborator_count","full_description","

🚀 Full QFieldCloud Stack for ARM64 (Raspberry Pi 4/5)

This stack is specifically patched and compiled for ARM64 architecture. It allows running a full QFieldCloud instance on a Raspberry Pi 4 or 5. 🐧

\n \n

\n 📦 Required Custom ARM64 Images:\n

Main App & Worker: samexit/qfieldcloud-app-arm64:latest
QGIS Engine: samexit/qgis-arm64:3.34

\n
\n

⚠️ Instructions: Replace all 🔹your-value🔹 with your specific domain, passwords, and local paths.

\n\n
\n\n

1️⃣ File: .env

Environment variables and security keys. 🔑

\n# --- GENERAL CONFIG ---\nDEBUG=0\nQFIELDCLOUD_HOST=🔹your-domain.com🔹\nENVIRONMENT=production\nSECRET_KEY=🔹REPLACE_WITH_A_LONG_RANDOM_STRING🔹\nSALT_KEY=🔹REPLACE_WITH_A_RANDOM_SALT🔹\n\n# --- DATABASE (Postgres) ---\nPOSTGRES_USER=🔹db_admin_user🔹\nPOSTGRES_PASSWORD=🔹STRONG_PASSWORD🔹 # Required for database security\nPOSTGRES_DB=qfieldcloud_db\nPOSTGRES_HOST=db\nPOSTGRES_PORT=5432\n\n# --- DOMAINS & SECURITY ---\nDJANGO_ALLOWED_HOSTS=\"🔹your-domain.com🔹 localhost 127.0.0.1 app 🔹192.168.1.XX🔹\"\nCSRF_TRUSTED_ORIGINS=\"https://🔹your-domain.com🔹 http://🔹192.168.1.XX🔹:8010\"\n\n# --- CUSTOM ENGINE ---\nQFIELDCLOUD_QGIS_IMAGE_NAME=samexit/qgis-arm64:3.34\n\n# --- STORAGE (Minio) ---\nMINIO_ROOT_USER=minioadmin\nMINIO_ROOT_PASSWORD=minioadmin # Required for S3 storage access\nQFIELDCLOUD_ADMIN_EMAIL=🔹your-email@example.com🔹

\n\n
\n\n

2️⃣ File: docker-compose.yml

Core infrastructure with all services. 📦

\nversion: '3.8'\n\nservices:\n  db:\n    image: kartoza/postgis:15-3.4\n    container_name: qfield_db\n    restart: unless-stopped\n    environment:\n      - POSTGRES_DB=${POSTGRES_DB}\n      - POSTGRES_USER=${POSTGRES_USER}\n      - POSTGRES_PASS=${POSTGRES_PASSWORD}\n      - ALLOW_IP_RANGE=0.0.0.0/0\n    volumes:\n      - 🔹/your/path/🔹postgres_data:/var/lib/postgresql\n\n  redis:\n    image: redis:latest\n    container_name: qfield_redis\n    restart: unless-stopped\n\n  memcached:\n    image: memcached:latest\n    container_name: qfield_memcached\n    restart: unless-stopped\n\n  app:\n    image: samexit/qfieldcloud-app-arm64:latest\n    container_name: qfield_app\n    user: \"root\"\n    depends_on:\n      - db\n    ports:\n      - \"8010:8000\"\n    environment:\n      - DJANGO_SETTINGS_MODULE=qfieldcloud.settings\n      - POSTGRES_HOST=db\n      - POSTGRES_USER=${POSTGRES_USER}\n      - POSTGRES_PASSWORD=${POSTGRES_PASSWORD}\n      - POSTGRES_DB=${POSTGRES_DB}\n      - QFIELDCLOUD_HOST=${QFIELDCLOUD_HOST}\n      - SECRET_KEY=${SECRET_KEY}\n      - STORAGE_ACCESS_KEY_ID=${MINIO_ROOT_USER}\n      - STORAGE_SECRET_ACCESS_KEY=${MINIO_ROOT_PASSWORD}\n      - STORAGE_BUCKET_NAME=qfieldcloud\n      - STORAGE_ENDPOINT_URL=http://minio:9000\n      - STORAGE_USE_S3=True\n    volumes:\n      - 🔹/your/path/🔹staticfiles:/usr/src/app/staticfiles:rw\n      - 🔹/your/path/🔹media:/usr/src/app/media:rw\n    command: >\n      sh -c \"python3 manage.py migrate --noinput &&\n             python3 manage.py collectstatic --noinput &&\n             python3 manage.py runserver 0.0.0.0:8000\"\n\n  worker:\n    image: samexit/qfieldcloud-app-arm64:latest\n    container_name: qfield_worker\n    restart: unless-stopped\n    depends_on:\n      - app\n    environment:\n      - QFIELDCLOUD_QGIS_IMAGE_NAME=samexit/qgis-arm64:3.34\n    volumes:\n      - 🔹/your/path/🔹media:/usr/src/app/media:rw\n\n  minio:\n    image: minio/minio:latest\n    container_name: qfield_minio\n    restart: unless-stopped\n    volumes:\n      - 🔹/your/path/🔹minio_data:/data1\n    environment:\n      MINIO_ROOT_USER: ${MINIO_ROOT_USER}\n      MINIO_ROOT_PASSWORD: ${MINIO_ROOT_PASSWORD}\n    command: server /data1 --console-address :9001\n\n  ofelia:\n    image: mcuadros/ofelia:0.3.18\n    container_name: qfield_ofelia\n    restart: unless-stopped\n    command: daemon --docker\n    volumes:\n      - /var/run/docker.sock:/var/run/docker.sock:ro\n\n  nginx:\n    image: nginx:stable-alpine\n    container_name: qfield_nginx\n    restart: always\n    ports:\n      - \"8081:80\"\n    volumes:\n      - 🔹/your/path/🔹nginx/conf.d:/etc/nginx/conf.d:ro\n      - 🔹/your/path/🔹staticfiles:/usr/share/nginx/html/static:ro\n      - 🔹/your/path/🔹media:/usr/share/nginx/html/static:ro\n    depends_on:\n      - app

\n\n
\n\n

3️⃣ File: docker-compose.override.standalone.yml

Production optimizations for ARM64 standalone mode. ⚡

\nversion: '3.8'\nservices:\n  db:\n    volumes:\n      - ~/qfield_db_local:/var/lib/postgresql/15/main\n    restart: always\n\n  app:\n    image: samexit/qfieldcloud-app-arm64:latest\n    container_name: qfield_app\n    ports:\n      - \"8010:8000\"\n    command: >\n      sh -c \"python3 manage.py collectstatic --noinput &&\n             gunicorn qfieldcloud.wsgi:application --bind 0.0.0.0:8000 --workers 2\"\n\n  worker:\n    image: samexit/qfieldcloud-app-arm64:latest\n    container_name: qfield_worker\n    restart: always\n    user: \"root\"\n    command: python3 manage.py rqworker delta qgis\n\n  nginx:\n    container_name: qfield_nginx\n    image: nginx:alpine\n    ports:\n      - \"🔹8085🔹:80\"\n    volumes:\n      - 🔹/your/path/🔹staticfiles:/usr/share/nginx/html/static:ro\n      - ./nginx_simple.conf:/etc/nginx/conf.d/default.conf:ro

\n\n
\n\n

4️⃣ File: nginx_simple.conf

Reverse proxy and static files management. 🌐

\nserver {\n    listen 80;\n    server_name _;\n\n    location / {\n        proxy_pass http://app:8000;\n        proxy_set_header Host $host:🔹8085🔹;\n        proxy_set_header X-Real-IP $remote_addr;\n        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;\n        proxy_set_header X-Forwarded-Proto $scheme;\n        proxy_set_header X-Forwarded-Host $host:🔹8085🔹;\n    }\n\n    location /staticfiles/ {\n        alias /usr/share/nginx/html/static/;\n        expires 30d;\n        add_header Cache-Control \"public, no-transform\";\n    }\n}

\n\n
\n\n

🛠️ Deployment & Database Setup

\n \n

1. Start the services: 🚀

\n docker compose -f docker-compose.yml -f docker-compose.override.standalone.yml up -d\n

\n

2. Run Database Migrations: 🗄️

\n docker exec -it qfield_app python3 manage.py migrate\n

\n

3. Create Superuser (Admin Access): 👤

\n docker exec -it qfield_app python3 manage.py createsuperuser\n

\n\n
\n\n

🙏 Credits & Thanks

\n Thanks to OPENGIS.ch and Kartoza for the ARM64 images! 🥹\n

\n 🔗 Official Project: Visit the QFieldCloud GitHub Repository\n

\n","has_starred","hub_user","immutable_tags_settings",{"_79":11,"_80":81},"enabled","rules",[82],".*","is_automated","permissions",{"_86":22,"_87":11,"_88":11},"read","write","admin","user","storage_size",837317106,"orgData","recentTags",[95],{"_96":49,"_97":98,"_99":100,"_101":102,"_103":104,"_105":106,"_55":123,"_124":98,"_125":33,"_126":61,"_43":127,"_128":129,"_130":113,"_131":123,"_132":70,"_133":22},"content_type","creator",39902913,"digest","sha256:270d82e512deff9c2e47c2e9b9a194033ad4ebde2a5656eac8ca31ee6450b524","full_size",330400804,"id",1080803954,"images",[107],{"_108":109,"_99":100,"_110":111,"_112":113,"_114":115,"_116":117,"_118":111,"_119":-5,"_120":102,"_67":70,"_121":122},"architecture","arm64","features","","last_pulled","2026-10-29T01:30:42.291972534Z","last_pushed","2026-02-22T17:45:19.244966055Z","os","linux","os_features","os_version","size","variant","v8","2026-02-22T17:45:19.700634Z","last_updater","last_updater_username","media_type","latest","repository",30166140,"tag_last_pulled","tag_last_pushed","tag_status","v2","sbxKitMetadata","isPotentialSpam","isHubSbxKitsEnabled","showSbxRunInCloud","showSbxLogoOverride","sbxTrademarkText","displaySecurityMetadata","tagAttestations","tagsHaveAttestations",[],"selectedTag","attestationsUrl","routes/_layout.r.$namespace.$reponame.tags",{"_38":148,"_156":157,"_142":166,"_167":11},{"_40":149,"_47":151,"_50":51,"_52":53,"_54":11,"_55":56,"_57":58,"_59":152,"_43":35,"_32":33,"_62":63,"_64":49,"_65":66,"_67":68,"_69":70,"_71":-5,"_72":66,"_73":74,"_75":11,"_76":33,"_77":153,"_83":11,"_84":155,"_89":33,"_90":91},[150],{"_43":44,"_45":46},[49],[61],{"_79":11,"_80":154},[82],{"_86":22,"_87":11,"_88":11},"tags",{"_158":68,"_159":-5,"_160":-5,"_161":162},"count","next","previous","results",[163],{"_96":49,"_97":98,"_99":100,"_101":102,"_103":104,"_105":164,"_55":123,"_124":98,"_125":33,"_126":61,"_43":127,"_128":129,"_130":113,"_131":123,"_132":70,"_133":22},[165],{"_108":109,"_99":100,"_110":111,"_112":113,"_114":115,"_116":117,"_118":111,"_119":-5,"_120":102,"_67":70,"_121":122},[],"canDeleteTags","actionData","errors"]

samexit/qfieldcloud-app-arm64

Tags for samexit/qfieldcloud-app-arm64