ODK Central is the ODK server. It manages user accounts and permissions, stores form definitions, and allows data collection clients like ODK Collect to connect to it for form download and submission upload. ODK Central Frontend provides the frontend for ODK Central using Vue.js.
This repository contains the code for the frontend of ODK Central. The central-backend
repository contains the code for the backend API server. The central
repository contains the Docker code for building and running a production Central stack. You can find release notes in the central
repository.
The master
branch of this repository reflects ongoing development for the next version of ODK Central. It may or may not be in sync with the master
branch of the central-backend
repository. For the latest stable version, see the release tags.
You can learn more about ODK Central by visiting the docs.
We need your help to make ODK Central Frontend as useful as possible! Please see the Contribution Guide for detailed information on discussion forums, project policies, code guidelines, and an overview of the software architecture.
Follow these steps to set up your development environment:
npm install
.Follow these instructions to run ODK Central Frontend in development. For deploying to production, see the next section.
First, run ODK Central Backend.
Next, build ODK Central Frontend files for development by running npm run dev
. The files will be outputted to dist/
. As you update the source code, the files will be automatically rebuilt. npm run dev
will also start NGINX, which will serve the files. NGINX effectively places ODK Central Frontend and ODK Central Backend at the same origin, avoiding cross-origin requests.
ODK Central Frontend will be available on port 8989.
ODK Central Frontend communicates with ODK Central Backend in part using a session cookie. The cookie is Secure
, but will be sent over HTTP on localhost. ODK Central Frontend also interacts with data collection clients and with services:
ngrok
. ODK Central Frontend is available on port 8989, so you can run ngrok http 8989
to expose a temporary HTTPS URL that you can use. Within ODK Central Backend, you will also need to set the default.env.domain
property in config/default.json
to the HTTPS URL, then restart ODK Central Backend if it is already running.To build ODK Central Frontend files for production with minification, run npm run build
. The files will be outputted to dist/
. For more details on this command, see the documentation for Vue CLI.
Note that this repository's main.nginx.conf
is for development only.
For more information on deploying to production, see the central
repository.