Upload images to WebODM

  • Updated

You can send images from the web app to your WebODM server. WebODM is open-source software from OpenDroneMap. It makes maps and 3D models from drone images. For the general steps of an upload, read Uploads: send images to processing and storage services.

The web app makes a task in WebODM and sends the images to it. WebODM starts to process the images when the upload is complete.

What you need

  • A WebODM server and a user name and password for it. To get WebODM, click the icon at the right end of the OpenDroneMap WebODM row in the New Upload dialog. The Dronelink WebODM page opens in a new tab.
  • A server address that the browser can reach from app.dronelink.com. Read "Server address rules" below.
  • A computer browser at app.dronelink.com.
  • A plan that includes this integration. To see which plans include it, find "WebODM" in the plan comparison table.

For WebODM offers for Dronelink users, see the Dronelink WebODM page.

Server address rules

The browser sends the images directly to your WebODM. From app.dronelink.com, the server must agree with one of these rules:

  • The address starts with https://, for example https://webodm.example.com.
  • The server runs on the same computer as the browser, for example http://localhost:8000.

A server with an http:// address on a different computer does not work. The browser blocks it.

If you do not enter http:// or https://, the web app adds https://. For localhost, it adds http://.

In Chrome, the first connection to a server on your computer or on your local network asks for permission. Allow it. If you blocked it, open the Chrome site settings for app.dronelink.com. Allow Apps on device for localhost, or Local network for other local addresses. Then connect again.

Connect to the server

  1. Open Uploads and click New Upload.
  2. Click OpenDroneMap WebODM.
  3. In Server URL, enter the address of your WebODM.
  4. Enter your WebODM Username and Password.
  5. Click Connect Account.

The project and preset fields show when the connection is complete. The browser keeps the server URL and the username for the next upload. It does not keep the password.

Settings

  • Project: the WebODM project for the task. Select a project, or select New project. The list shows the newest project first. If the server has projects, the web app selects the newest project. Make sure that it is the correct project.
  • Project Name: the name of the new project. This field shows only for New project. If you start the upload from a mission page, the default is the mission name.
  • Task Name: the name of the task in WebODM. If you do not enter a name, the web app uses "Dronelink" and the date and time of the upload. If you start the upload from a mission page, the default is the mission name and the capture time.
  • Processing Preset: the processing options of the task. The list shows the presets of your server, for example Default and Fast Orthophoto. The web app selects Default if the server has it.

The WebODM settings after Connect Account

Select only images

WebODM reads each .txt file in a task as a ground control point (GCP) file or a geolocation file. If a different text file is in the task, processing can fail immediately.

  • Select only the images.
  • Add a gcp_list.txt or geo.txt file only when you want WebODM to use it.

After the upload

When all images are in the task, the web app tells WebODM to start the processing. To see the task, click Open on the upload card. The task opens in WebODM in a new tab.

A finished WebODM upload card with the Open button

The processing time depends on your server and on the preset.

Troubleshooting

  • "Could not connect to the WebODM server. Check the server URL. From app.dronelink.com, the server must use https:// or run on this computer (http://localhost).": make sure that the server is on, and that the address agrees with the server address rules.
  • "Your browser blocked this site from reaching servers on your computer or local network. In the browser's settings for this site, allow access to apps on this device (for localhost) and to the local network, then connect again.": allow the permission in the browser settings for app.dronelink.com. Then connect again.
  • Other messages when you connect: WebODM sent the message, for example for a wrong username or password.
  • Processing failed immediately: make sure that the task has no .txt file that is not a GCP or geolocation file.
  • "Error: Upload failed" or "Error: Upload failed with status" and a number: an image did not get to the server. The web app sends a failed image again, up to 3 times. If the server refused the image, for example with status 403 or 404, the web app does not send it again. If the image does not arrive, the upload stops.
  • A failed or stopped upload: WebODM keeps a task with the images that arrived. This task does not start processing. Delete it in WebODM. If the upload made a new project, delete the project too.
  • A long upload: the web app signs in to WebODM again when the sign-in is about to expire. For this, it keeps the password in the memory of the page until you reload the page.

Was this article helpful?

0 out of 0 found this helpful