Use Docker Oasys container - oasys-kit/oasys-installation-scripts GitHub Wiki

1) Setup Docker tools in your computer

1. Sign In or Sign Up to Docker Hub
2. Install Docker Desktop in your computer
3. Install VNC Viewer (Windows users can use Remote Desktop Client)

Verify docker is running on your host. In a terminal window run: docker --version.

The result should be similar to: Docker version 19.03.13, build 4484c46d9d

2) Run Oasys Docker Container

1. You need a local directory in your home directory named "workspaces", with full permissions. That folder will be shared with the Docker instance and will allow you to open your local files.

2. Create a directory "oasys" wherever you want

3. open a terminal and type: cd <path to oasys directory>/oasys

4. run command docker login to link to docker hub using the user and password you set up for docker hub

5. run command: docker run -itd --rm -p 5901:5901 -v /dev/shm:/dev/shm -v $HOME/workspaces:/workspaces lucarebuffi/oasys1.2

6. verify the container is on by typing: docker ps

7. open VNC Viewer or Remote Desktop Client and connect to "localhost:5901". The password is "123456"

8. the docker Linux virtual instance should appear and the icon OASYS is on the Desktop. Double click it and run the application.

images/docker.png

3) stop the Oasys container

ALWAYS exit the VNC Viewer or Remote Desktop Client before stopping and starting the container. If not, the port 5901 remains open and the container will not connect to that port.

1. run command: docker ps, then copy the CONTAINER ID

2. run command: docker stop <CONTAINER ID>