jbaranski · August 1, 2020 14:52 · Aug 1, 2020
diff --git a/SelfHostOpenStreetMapDocker.md b/SelfHostOpenStreetMapDocker.md
@@ -0,0 +1,66 @@
+Here are the steps needed to run a self hosted Open Street Map server (using Docker):
+
+1. Download desired `pbf` files (like `south-carolina-latest.osm.pbf`) from <https://download.geofabrik.de> or just use the following empty planet below:
+
+    ```
+
+      <?xml version='1.0' encoding='UTF-8'?>
+      <osm version="0.6" generator="osmconvert 0.8.8" timestamp="2019-10-23T20:18:02Z">
+        <bounds minlat="42.4276" minlon="1.412368" maxlat="42.65717" maxlon="1.787481"/>
+      </osm>
+    ```
+
+2. Download `osmconvert` from <https://wiki.openstreetmap.org/wiki/Osmconvert>.
+
+3. If you decided to use `empty-planet.osm`, we need to get it in `pbf` format, so run:
+
+    ```
+
+      osmconvert empty-planet.osm -o=data.osm.pbf
+    ```
+
+4. If you decided to download some `pbf` files, we need to concatenate them together, so run (replacing the `pbf` and `o5m` file names where necessary):
+
+    ```
+
+      osmconvert south-carolina-latest.osm.pbf -o=south-carolina-latest.o5m
+      osmconvert north-carolina-latest.osm.pbf -o=north-carolina-latest.o5m
+      osmconvert south-carolina-latest.o5m north-carolina-latest.o5m -o=data.o5m
+      osmconvert data.o5m -o=data.osm.pbf
+    ```
+
+5. Create a `Dockerfile` with the following content (in the same directory where your `data.osm.pbf` is):
+
+    ```
+
+      FROM overv/openstreetmap-tile-server
+      COPY data.osm.pbf /data.osm.pbf
+      RUN /run.sh import
+      VOLUME ["/var/lib/postgresql/12/main", "/var/lib/mod_tile"]
+      ENTRYPOINT ["/run.sh", "run"]
+    ```
+
+    See <https://github.com/Overv/openstreetmap-tile-server> for more information about the base image used.
+
+6. Build the container:
+
+    ```
+
+      docker build . -t osm-self-hosted
+    ```
+
+7. Run the container:
+
+    ```
+
+      docker run -p 80:80 -p 5432:5432 --name osm-self-hosted -e ALLOW_CORS=1 -d osm-self-hosted run
+    ```
+
+    Port `80` is for the client. Port `5432` is for the database server. `ALLOW_CORS=1` will enable CORS in case your client is served from a different domain.
+
+8. Navigate to <http://localhost> in your browser. A simple example client will show the map if everything worked properly.
+
+9. You can connect to the database using pgAdmin with the following info:
+    - Host: `localhost:5432`
+    - Maintenance database: `gis`
+    - User/pass is `renderer`