Skip to content

Commit 5cf8e65

Browse files
authored
Merge pull request #208 from smathermather/add_building
add howto on image builds
2 parents 5c1b4e3 + 16149f0 commit 5cf8e65

File tree

1 file changed

+45
-0
lines changed

1 file changed

+45
-0
lines changed

README.md

Lines changed: 45 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -30,6 +30,51 @@ Linux users can connect to 127.0.0.1.
3030

3131
If the computer running NodeODM is using an old or 32bit CPU, you need to compile OpenDroneMap from sources and setup NodeODM natively. You cannot use docker. Docker images work with CPUs with 64-bit extensions, MMX, SSE, SSE2, SSE3 and SSSE3 instruction set support or higher. Seeing a `Illegal instruction` error while processing images is an indication that your CPU is too old.
3232

33+
### Building docker image
34+
35+
If you need to test changes as a docker image, you can build easily as follows:
36+
37+
```
38+
docker build -t my_nodeodm_image --no-cache .
39+
```
40+
41+
Run as follows:
42+
43+
```
44+
docker run -p 3000:3000 my_nodeodm_image &
45+
```
46+
47+
48+
### Testing alternative ODM images through NodeODM
49+
50+
In order to test alternative ODM docker images in NodeODM, you will need to change the dockerfile for NodeODM to point to your ODM image. For example if you built an alternate ODM image as follows:
51+
52+
```
53+
docker build -t my_odm_image --no-cache .
54+
```
55+
56+
Then modify NodeODM's Dockerfile to point to the new ODM image in the first line:
57+
58+
```
59+
FROM my_odm_image
60+
MAINTAINER Piero Toffanin <[email protected]>
61+
62+
EXPOSE 3000
63+
...
64+
```
65+
66+
Then build the NodeODM image:
67+
68+
```
69+
docker build -t my_nodeodm_image --no-cache .
70+
```
71+
72+
Finally run as follows:
73+
74+
```
75+
docker run -p 3000:3000 my_nodeodm_image &
76+
```
77+
3378
### Running rootless
3479

3580
* A rootless alternative to Docker is using [Apptainer](https://apptainer.org/). In order to run NodeODM together with ClusterODM in rootless environments, for example on HPC, we need a rootless alternative to Docker, and that's where Apptainer comes in to play. From the Linux command line, cd into the NodeODM folder and run the following commands to host a NodeODM instance:

0 commit comments

Comments
 (0)