Installation

Requirements: Webserver with php and pdo extension, RDM database.

Easiest way to install the tools is to "git clone https://github.com/PickleRickVE/RealDeviceMap-tools" on your webserver. In config directory copy config.env.php to config.php and fill-in your credentials for RDM database. Settings for manualdb and an own tileserver are optional. If you want to protect your tools with a login, copy .htaccess.example to .htaccess and change the path for the .passwd file. It has to be the absolute path. Initial username/password is admin/admin. New users can be added via 'htpasswd -c /var/www/html/config/.htpasswd "username"' or via a htpasswd generator and manually editing the .htpasswd

Docker:

If you have difficulties connecting to your database, safest way is to use docker.

1. Clone the repo wherever you want on your server and cd into the new folder.
2. If you want password protection, simply uncomment the line with .htaccess in Dockerfile.
3. Do "docker build -t rdmtools ." to build a local docker image.
4. Add the following to your docker-compose.yml where your database is included:

  tools:
    image: rdmtools:latest
    container_name: rdmtools
    depends_on:
      - db
    volumes:
      - ./tools_config:/var/www/html/config/
      - /etc/localtime:/etc/localtime:ro
    ports:
      - 9006:80

4. Create directory "tools_config" and put your config.php into it. Fill in "db" for DB_HOST. If you've built the image with password protection, you have to copy the .htpasswd too.

After starting docker you'll reach your tools at http://your-server:9006. For updates simply git pull and repeat step 2.