diff --git a/topics/index.adoc b/topics/index.adoc index dc3c3d8..42a1396 100644 --- a/topics/index.adoc +++ b/topics/index.adoc @@ -8,6 +8,8 @@ ifndef::imagesdir[:imagesdir: ./img/] include::introduction.adoc[] +include::quick-deployment-guide.adoc[] + include::geocml-desktop.adoc[] include::geocml-postgres.adoc[] diff --git a/topics/introduction.adoc b/topics/introduction.adoc index 588d830..1f9d381 100644 --- a/topics/introduction.adoc +++ b/topics/introduction.adoc @@ -33,24 +33,6 @@ geoCML is currently limited in the following areas: geoCML base deployments are customizable to fit your specific needs. You can customize your services however you'd like! If you would like to contribute to the development of geoCML, you can find the project on GitHub at https://github.com/geocml[github.com/geocml]. -=== Quick deployment guide - -_Get up and running with geoCML in under 15 minutes!_ - -geoCML deployments are multi-paradigm, offering a desktop, server, and web GIS experience with a single deployment. You may host your geoCML instance locally or in the cloud, depending on your needs. - -Before instantiating a geoCML deployment, you must have https://www.docker.com/[Docker] and https://docs.docker.com/compose/install/[Docker Compose] installed on the machine you want to host geoCML on. You do not need any additional GIS software installed on the host machine. Once you have satisfied these conditions, please follow the following steps to deploy your geoCML instance. - -. Clone the geoCML source code from https://github.com/geocml/geocml-base-deployment[github.com/geocml/geocml-base-deployment] -. Open a terminal and cd into the source code directory -. Copy `.env.example` into a new file called `.env` -. Update your `.env` to include your deployment specific configuration variables -. Run `sh build.sh` to build geoCML service images on your machine. -. Run `docker network create geocml-network` -. Run `sh start.sh` to bring up the instance. - -That's it! You can access geoCML Desktop via {deployment host URL}:10000 or geoCML Server Portal via {deployment host URL}:80 using a web browser. Further configuration steps for each of these services are discussed in later topics. - === Using hosted geoCML images from GHCR The geoCML development team hosts pre-built containers at our container registry on Github. These containers are a great way to demo geoCML, but please note that these services are _not production ready_, because they lack the required build arguments. If you want to use geoCML in production, please build your containers. diff --git a/topics/quick-deployment-guide.adoc b/topics/quick-deployment-guide.adoc new file mode 100644 index 0000000..ddb9f57 --- /dev/null +++ b/topics/quick-deployment-guide.adoc @@ -0,0 +1,18 @@ +== Quick deployment guide + +_Get up and running with geoCML in under 15 minutes!_ + +geoCML deployments are multi-paradigm, offering a desktop, server, and web GIS experience with a single deployment. You may host your geoCML instance locally or in the cloud, depending on your needs. + +Before instantiating a geoCML deployment, you must have https://www.docker.com/[Docker] and https://docs.docker.com/compose/install/[Docker Compose] installed on the machine you want to host geoCML on. You do not need any additional GIS software installed on the host machine. Once you have satisfied these conditions, please follow the following steps to deploy your geoCML instance. + +. Clone the geoCML source code from https://github.com/geocml/geocml-base-deployment[github.com/geocml/geocml-base-deployment] +. Open a terminal and cd into the source code directory +. Copy `.env.example` into a new file called `.env` +. Update your `.env` to include your deployment specific configuration variables +. Run `sh build.sh` to build geoCML service images on your machine. +. Run `docker network create geocml-network` +. Run `sh start.sh` to bring up the instance. + +That's it! You can access geoCML Desktop via {deployment host URL}:10000 or geoCML Server Portal via {deployment host URL}:80 using a web browser. Further configuration steps for each of these services are discussed in later topics. +