What are the most basic requirements for running ISLE?

[rosiel]

The ISLE-DC documentation written in #1635 is meant to be a way for non-technical users to install a simple and most importantly, update-able, sandbox on their local machines.

But I was only able to document MY experience, and I already had many techy things installed on my Mac: Perl, Mac Development Tools (which require and Apple account), Composer, Ansible, Git, PHP, VirtualBox... I was also running as a user with sudo powers and who knows what else.

We need someone with a stock laptop to walk through the installation process - mac or windows - and document the actual requirements!

[rosiel]

Thanks @dflitner - Windows doesn't have make available by default.

[dannylamb]

On windows everything has to be run using WSL2, so we definitely need to highlight that as an essential requirement.

Been a while, so YMMV, but I went through it when my laptop died and I needed git, php, composer, and a handful of php packages. php-mysql and php-mbstring are the two i can recall specifically.

[eldonquijote]

@dannylamb Is that because ISLE will not work with Docker for Windows using Hyper-V? I haven't tested that part yet, and I understand Docker Desktop uses WSL2 behind the scenes.

I can in any case document a walkthrough for non-technical users using a relatively mint Windows with WSL2 and Ubuntu or Debian (both worked).

[archivalGrysbok]

It'd be wicked helpful if there was a link or something to how to install ubuntu on a windows machine.
(Hi! I have a newish desktop and this is the first techie thing I've tried installing locally. I'll post what pain points I encounter as I encounter them.)

[archivalGrysbok]

Context: I'm SSHed into a remote shared CentOS 7 development machine. This is the first thing I've tried running using docker. I have sudo privileges.

• One thing that isn't mentioned on the docker-compose install how-to ( https://islandora.github.io/documentation/installation/docker-compose/ ) is that docker needs to be running (in my case, using systemctl start docker ).
  The "docker's not running" error is a bit obtuse.--

... lots of traceback ...
docker.errors.DockerException: Error while fetching server API version: ('Connection aborted.', FileNotFoundError(2, 'No such file or directory'))
[15741] Failed to execute script docker-compose
make[1]: *** [pull] Error 255
make[1]: Leaving directory `/home/USERNAME/2021-05-27_islandora/isle-dc'
make: *** [demo] Error 2

• Also, a bit of a how-to for changing ports would be nice. I think the way to do it is to edit the traefik yml file (nano docker-compose.traefik.yml) and edit the ports, for example:

ports:
      - 8983:8983   # solr line before editing

ports:
      - 18983:8983   # solr line after editing

• I'm still trying to figure out how to see https://islandora.traefik.me:10443/ in a browser, from my windows desktop on the same network. I know it's there because wget https://islandora.traefik.me:10443/ --no-check-certificate downloads a happy drupal page. I just can't get it to show up at myurl.com/islandora/ . I'm sure there's something I can do in my apache config, but I don't know what.