Skip to main content

Installation

Step 1 − Download files​

Go to your home directory

cd

Download the latest release to your home directory

wget https://github.com/plans-coding/immer-in-bewegung/archive/refs/tags/Loading....tar.gz

Step 2 − Unpack and run docker container​

Unpack the files

tar -xzvf Loading....tar.gz --strip-components=1 immer-in-bewegung-Loading.../bewegung-app

Go to the directory bewegung-app directory

cd bewegung-app

Initiate your Docker container from your bewegung-app directory

sudo docker compose up -d

Step 3 − Edit settings file​

nano edit bewegung/iib-settings.yaml
### Add your data source
trip-data:
  - provider: google-sheet
    spreadsheet-id: ENTER-YOUR-GOOGLE-SPREADSHEET-ID #<-----
    spreadsheet-name: ENTER-YOUR-GOOGLE-SPREADSHEET-NAME #<-----
    overview-name: Overview
    overview-gid: ENTER-OVERVIEW-GID #<-----
    events-name: Events
    events-gid: ENTER-EVENTS-GID #<-----
    map-name: Map
    map-gid: ENTER-MAP-GID #<-----

### Change Immich settings
immich-settings:
  immich-server-address: http://localhost:2283/ # Front-end address - Remember last dash /

  # If you are using Docker, this address should probably NOT be changed (http://immich_server:3001/api/)
  # If you deploy file to web server directly then it is probably http://127.0.0.1:2283/api/
  immich-server-api-address: http://immich_server:3001/api/ # Back-end address - Remember last dash /

   # Generate and paste an api key in Immich under http://localhost:2283/user-settings?isOpen=api-keys
  immich-server-api-key: OqMvcxTWJ2VJpSRBbTxjAFFYN0KXJMSQLZbUBMY2a8

Step 4 − Save trip data from data set​

Save your three sheets in tsv format to

bewegung-app/www/data/

Read more under Create the dataset.

Step 5 − Test you installation​

Your instance is now reachable at

http://localhost:2024/
Stop docker container

If you wish to stop your Docker container you can inactivate it from your bewegung-app directory using command

sudo docker compose down

Install on bare metal​

  • Install a webserver (Nginx or Apache with PHP 8.2)
  • Install yaml for php (sudo apt-get install php-yaml)
  • Deploy the files from bewegung-app folder
INSTALLATION AS WEB APP

If you deploy the files to a subfolder (https://your-address.com/subfolder/) you need to update the manifest.json file and update start_url from / to /subfolder/.

USER AUTHENTICATION

Make sure not to expose your files to the web directly without proper user authentication, Read more under Other needs