Setup

  1. Install Docker > Setup.
  2. Clone IIC-OSIC-Tools repo.
git clone --depth=1 https://github.com/iic-jku/iic-osic-tools.git
  1. Set Environment Variables.
  2. Start either VNC (full desktop environment) or X-Server (apps render as native windows) session.
  3. (optional) Create script to automate launch process.

VNC

cd iic-osic-tools

# unix
./start_vnc.sh

# windows
.\start_vnc.bat
  • http://localhost (open in web browser)
  • password: abc123

X-Server

cd iic-osic-tools

# unix
./start_x.sh

# windows
.\start_x.bat

Environment Variables

  1. Set design directory (mounted to /foss/designs in docker container).
# unix
export DESIGNS=$HOME/designs

# windows
$env:DESIGNS = "$env:USERPROFILE\designs"
  1. (optional) Set VNC port.
# unix
export VNC_PORT=5901

# windows
$env:VNC_PORT = 5901

Fish Script

#!/usr/bin/env fish

set VNC_PORT 5933
set SCRIPT $HOME/Tools/iic-osic-tools/start_vnc.sh
set CONTAINER_NAME iic-osic-tools 

# set environment variables
set -x VNC_PORT $VNC_PORT
set -x DESIGNS $HOME/Projects
set -x CONTAINER_NAME $CONTAINER_NAME

# run script
if test -f $SCRIPT
    echo "Running pre-VNC script..."
    $SCRIPT
end

# launch vnc session
vncviewer.exe localhost:$VNC_PORT

# stop container
docker stop $CONTAINER_NAME

Usage