You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+15-6Lines changed: 15 additions & 6 deletions
Original file line number
Diff line number
Diff line change
@@ -1,4 +1,3 @@
1
-
2
1
# How to use this image
3
2
4
3
By default, this image will clone an existing Overpass server for the whole planet, and make it available at `http://localhost/api/interpreter`.
@@ -24,17 +23,17 @@ The following enviroment variables can be used to customize the setup:
24
23
*`OVERPASS_USE_AREAS` - if `false` initial area generation and the area updater process will be disabled. Default `true`.
25
24
*`OVERPASS_HEALTHCHECK` - shell commands to execute to verify that image is healthy. `exit 1` in case of failures, `exit 0` when container is healthy. Default healthcheck queries overpass and verifies that there is reponse returned
26
25
*`OVERPASS_STOP_AFTER_INIT` - if `false` the container will keep runing after init is complete. Otherwise container will be stopped after initialization process is complete. Default `true`
26
+
*`OVERPASS_ALLOW_DUPLICATE_QUERIES` - if `yes`, duplicate queries (same query from the same IP address) will be allowed. Default `no`.
27
27
28
28
### Modes
29
29
30
30
Image works in two modes `init` or `clone`. This affects how the instance gets initialized:
31
31
32
32
*`init` - OSM data is downloaded from `OVERPASS_PLANET_URL`, which can be a full planet or partial planet dump.
33
-
This file will then be indexed by Overpass and later updated using `OVERPASS_DIFF_URL`.
34
-
33
+
This file will then be indexed by Overpass and later updated using `OVERPASS_DIFF_URL`.
35
34
*`clone` - data is copied from an existing server, given by `OVERPASS_CLONE_SOURCE`, and then updated using `OVERPASS_DIFF_URL`.
36
-
This mode is faster to set up, as the OSM planet file is already indexed.
37
-
The default clone source provides an Overpass instance using minute diffs covering the whole world (hourly or daily diffs will not work with this image).
35
+
This mode is faster to set up, as the OSM planet file is already indexed.
36
+
The default clone source provides an Overpass instance using minute diffs covering the whole world (hourly or daily diffs will not work with this image).
38
37
39
38
### Running
40
39
@@ -55,10 +54,13 @@ All data resides within the `/db` directory in the container.
55
54
For convenience, a [`docker-compose.yml` template](./docker-compose.yml) is included.
56
55
57
56
# Examples
57
+
58
58
## Overpass instance covering part of the world
59
+
59
60
In this example the Overpass instance will be initialized with a planet file for Monaco downloaded from Geofabrik.
60
61
Data will be stored in folder`/big/docker/overpass_db/` on the host machine and will not contain metadata as this example uses public Geofabrik extracts that do not contain metadata (such as changeset and user).
61
62
Overpass will be available on port 12345 on the host machine.
63
+
62
64
```
63
65
docker run \
64
66
-e OVERPASS_META=yes \
@@ -73,8 +75,10 @@ docker run \
73
75
```
74
76
75
77
## Overpass clone covering whole world
78
+
76
79
In this example Overpass instance will be initialized with data from main Overpass instance and updated with master planet diffs.
77
80
Data will be stored in `/big/docker/overpass_clone_db/` on the host machine and the API will be available on port 12346 on the host machine.
81
+
78
82
```
79
83
docker run \
80
84
-e OVERPASS_META=yes \
@@ -88,10 +92,12 @@ docker run \
88
92
```
89
93
90
94
## Overpass instance covering part of the world using cookie
95
+
91
96
In this example Overpass instance will be initialized with planet file for Monaco downloaded from internal Geofabrik server.
92
97
Data will be stored in `/big/docker/overpass_db/` on the host machine and the API will be available on port 12347 on the host machine.
93
98
94
99
Prepare file with your credentials `/home/osm/oauth-settings.json`:
100
+
95
101
```json
96
102
{
97
103
"user": "your-username",
@@ -122,7 +128,9 @@ docker run \
122
128
```
123
129
124
130
## Healthcheck checking that instance is up-to-date
0 commit comments