Skip to main content

Welcome to QFieldCloud Documentation

Learn how to synchronize your field data with your spatial infrastructure, manage teams, track changes, and work seamlessly online and offline with QField.

Get StartedAPI Reference
Field data synced
Team collaboration active
Offline changes tracked

Quick Start

Get up and running with QFieldCloud in just a few steps

1

Create your account

Sign up at app.qfield.cloud or deploy your own self-hosted instance using Docker Compose.
2

Create your first project

Upload your QGIS project files and configure your project settings. QFieldCloud supports versioned storage backends including S3 and MinIO.
# Or use the API to create a project
curl -X POST https://app.qfield.cloud/api/v1/projects/ \
  -H "Authorization: Token YOUR_AUTH_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name": "My Field Project", "owner": "username"}'
3

Sync with QField mobile

Download the QField app on your mobile device, connect to QFieldCloud, and start collecting field data offline. Changes are tracked as deltas for seamless synchronization.
4

Collaborate with your team

Invite team members, create organizations, and manage permissions with role-based access control. Track all changes with full audit history.

Explore by Topic

Dive deep into QFieldCloud’s powerful features

Projects

Create and manage QGIS projects with versioned file storage and change tracking

Collaboration

Work together with role-based permissions and team management

Synchronization

Seamlessly sync field data between QGIS desktop and QField mobile

Organizations

Set up organizations with teams, members, and subscription management

Self-Hosting

Deploy your own QFieldCloud instance with Docker Compose

API Integration

Integrate QFieldCloud into your workflows with our REST API

Development Resources

Contributing to QFieldCloud and building integrations

Local Development Setup

Set up your local development environment with Docker and start contributing

Architecture Overview

Understand QFieldCloud’s Django backend, worker system, and QGIS integration

Testing & Debugging

Run tests, debug issues, and maintain code quality with our test suite

Contributing Guide

Learn how to submit PRs, follow coding standards, and collaborate with the team

Ready to get started?

Whether you’re using our hosted service at qfield.cloud or deploying your own instance, QFieldCloud makes field data synchronization seamless.

Start BuildingView on GitHub

Build docs developers (and LLMs) love

Get started for freeTalk to us