forked from Ivasoft/geovisio-website
65 lines
1.9 KiB
Markdown
65 lines
1.9 KiB
Markdown
# Setup
|
|
|
|
GeoVisio website can be installed through classic method, or using Docker.
|
|
|
|
=== ":gear: Classic"
|
|
|
|
You need to have installed on your system:
|
|
|
|
* [NodeJS](https://nodejs.org/en/download) >= 18.13.0
|
|
* [NPM](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm) or [Yarn](https://yarnpkg.com/)
|
|
|
|
The website can be installed locally by retrieving this repository and installing dependencies:
|
|
|
|
```bash
|
|
# Retrieve source code
|
|
git clone https://gitlab.com/panoramax/server/website.git
|
|
cd website/
|
|
|
|
# Install dependencies
|
|
npm install
|
|
```
|
|
|
|
Then, you need to define some settings. You have to create a `.env` file and edit its content.
|
|
|
|
```sh
|
|
cp env.example .env
|
|
```
|
|
|
|
See _Configuration_ for more details about available settings.
|
|
|
|
Then, building for production can be done with these commands:
|
|
|
|
```sh
|
|
npm run build
|
|
PORT=3000 npm run start
|
|
```
|
|
|
|
The website is now available at [localhost:3000](http://localhost:3000).
|
|
|
|
|
|
=== ":simple-docker: Docker"
|
|
|
|
The [Docker](https://docs.docker.com/get-docker/) deployment is a really convenient way to have a Geovisio website running in an easy and fast way. Note that this setup documentation only covers __GeoVisio front-end__ (website), if you also need an API running, please refer to [Docker API deployment](https://gitlab.com/panoramax/server/api/-/blob/develop/docs/14_Running_Docker.md).
|
|
|
|
You can use the provided __Docker Hub__ `geovisio/website:latest` image directly:
|
|
|
|
```bash
|
|
docker run \
|
|
-e VITE_API_URL="https://your.geovisio.api/" \
|
|
-e VITE_INSTANCE_NAME="My Own GeoVisio" \
|
|
-e VITE_TILES="https://your.geovisio.api/vector/tiles/style.json" \
|
|
-p 3000:3000 \
|
|
--name geovisio-website \
|
|
-d \
|
|
geovisio/website:latest
|
|
```
|
|
|
|
This will run a container bound on [localhost:3000](http://localhost:3000).
|
|
|
|
You can also build the image from the local source with:
|
|
|
|
```bash
|
|
docker build -t geovisio/website:latest .
|
|
```
|