Panoramax streetviewing
Setting up and running a self-hosted Panoramax streetview facility requires several applications.
Panoramax API and Website
We discussed elsewhere setting up a Panoramax API with a Panoramax viewer that was incorporated into a web application. However, it is useful to set up a Panoramax Website so that photos can be uploaded directly and managed. For a fully updated Ubuntu 22.04 system, installing the API and Website are straightforward. Be aware that the default versions for git clones are development versions (git clone https://gitlab.com/panoramax/server/api.git; git clone https://gitlab.com/panoramax/server/website.git).
Panoramax requires a PostgreSQL data base version 12 or greater and PostGIS extension 3.4+ We found that the database (version 12) and PostGIS extension (version 3.5.2) could be installed using standard terminal commands:sudo apt install postgres
sudo apt install postgresql-12-postgis-3
The database setup is standard. For the API, a virtua enviroment is needed for the directory where the API clone is stored (say /home/user/geoviso):
python3 -m venv .
source bin/activate
Dependencies are then installed:
pip install -e .
To start it is probably best to use the built.in Fask server:
flask runFlask requires a .env file in /home/user/geovisio. A suitable .env is:
FLASK_APP=geovisio
# optional FLASK_DEBUG=1
DB_URL=postgres://ertert:ertert@localhost:5432/geovisio
FS_URL=/home/ertert/geovisio/data
INFRA_NB_PROXIES=1
FLASK_RUN_HOST=0.0.0.0
API_WEBSITE_URL=same-host
FLASK_SESSION_COOKIE_DOMAIN=peterboswell.net
FLASK_SESSION_COOKIE_HTTPONLY=false
FLASK_SESSION_COOKIE_SAMESITE=none
FLASK_SESSION_COOKIE_SECURE=true
OAUTH_PROVIDER=osm
OAUTH_CLIENT_ID=*********************
OAUTH_CLIENT_SECRET=***********************
FLASK_SECRET_KEY=**********************
# fine tuning
#GEOVISIO_IMAGE_TAG=latest
#API_FORCE_AUTH_ON_UPLOAD=false
#API_DEFAULT_COLLABORATIVE_METADATA_EDITING=false
#API_ENFORCE_TOS_ACCEPTANCE=false
#API_ACCEPT_DUPLICATE=false
#DEBUG_PICTURES_SKIP_FS_CHECKS_WITH_PUBLIC_URL=true
#API_PERMANENT_PICTURES_PUBLIC_URL=true
While most of these settings are discussed in the settings documentation (with further details on the Flask website), some require more attention.
Proxy
The INFRA_NB_PROXIES=1 seeting specifies the number of proxies. It is recommendedthat the Paoramax webisite and API are n the same host. For an Apache2 webserer where the website is ered at http://192.168.1.100:5173 (the Vite default port - see below) and the API at http://192.168.1.100:5000 (the Flask default port) for https connections we use:
<IfModule mod_ssl>
<VirtualHost *:443>
ServerName pano.peterboswell.net
<LocationMatch "/api/"
Require all denied
RequestHeader set X-Forward Proto "https"
ProxyPass http://192.168.1.105:5173/
ProxyPassReverse http://192.168.1.105:5173/
</LocationMatch>
RequestHeader set X-Forward Proto "https"
ProxyPass http://192.168.1.105:3003/
ProxyPassReverse http://192.168.1.105:3003/
SSLCertificateFile /etc/letsencrypt/......
SSLCertificateKeyFile /etc/letsencrypt/......
</VirtualHost>
</IgModule>
