Installation
Mac Installation
This video presents how to install Poky on Mac. Poky requires the installation of XQuartz.app that you can find the link from the download page. If your computer does not allow to use the program downloaded from Internet, you will need to follow this instruction: https://osxdaily.com/2015/05/04/disable-gatekeeper-command-line-mac-osx
That is basically, type
sudo spctl --master-disable
Run the poky.app after unzipping poky_mac.zip
The poky.app can be moved into /Applications folder for your convenience.
System Preferences > Security & Privacy > General > Click the "Open Anyway" button for the first time may be necessary.
sudo spctl --master-enable if you wish to get the gatekeeper back
Also, giving the full disk access to poky, sh, launchd_startx, PokyAnalyzer.app, easy_ucsfdata.app, and ndpplot.app in System Preferences > Security & Privacy > Privacy may be necessary for Mac OS Catalina and newer versions of Mac OS.
XQuartz 2.8.5 beta 3 and newer have a flaw in drawing. Use 2.8.5 beta 2 or older unless this sentence is updated.
Windows Installation
This video presents how to install Poky on Windows 10. Poky does not quire any special installation steps other than uncompressing the poky_win.zip package and executing poky.bat in poky_win\bin folder. Some special external modules may require the installation of the VS redistribution package that you can find the link from the download page.
Linux Installation
In this video, you'll see how you can install Poky on Linux. We'll use Ubuntu 20.04 for this demonstration. There are some required libraries you need to install. Copy and paste this line in the terminal (only italics):
(Ubuntu-based) $ sudo apt install libxcb*-dev libcanberra-gtk-module
(Redhat-based) $ sudo dnf install libxcb*-devel xcb-util-*-devel libXrender-devel libxkbcommon*-devel libXi-devel libdrm-devel libXcursor-devel libXcomposite-devel libpng15
Then, extract poky_linux.zip and run poky_linux/bin/poky.sh to launch Poky.
For your convenience, you can alias the command (e.g. alias poky='poky_linux/bin/poky.sh' in .bash_aliases)
POKY Singularity Container for Older Linux Systems.
Make sure you have singularity installed.
Build a POKY singularity container:
wget https://poky.clas.ucdenver.edu/poky_releases/poky.def
(As an administrator) singularity build poky.sif poky.def
or
(As a regular user) singularity build --fakeroot poky.sif poky.def
Use --sandbox flag after build if it fails with the disk full error.
Launch the generated POKY singularity container:
singularity run /path/to/poky.sif
Use --writable flag after run if necessary.
If some windows remain after quitting POKY:
pkill -9 poky
For your convenience, you can alias the command (e.g. alias poky='singularity run /path/to/poky.sif' in .bash_aliases).
For troubleshooting regarding Singularity, please visit and read Sylabs's documentation [click here].
The installation path should have neither spaces nor special characters.
