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,
Download poky_mac.zip.
Download and install XQuartz 2.8.4.
(Optional) sudo spctl --master-disable
Unzip poky_mac.zip.
Run poky_macinstall.command file from Finder. Do not click the Move to trash button. Click Cancel instead. You can find poky in /Applications.
Less preferred way in case you are not an admin: The poky.app can be moved to your preferred place.
System Preferences > Security & Privacy > General > Click the "Open Anyway" button for the first time may be necessary.
System Preferences > Security & Privacy > Full Disk Access > add poky.app and XQuartz.app
Giving the full disk access to sh, launchd_startx, PokyAnalyzer.app, easy_ucsfdata.app, and ndpplot.app may be necessary in some cases
(Optional) sudo spctl --master-enable if you wish to get the gatekeeper back
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.
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.
Simpler approach would be,
Download poky_win.zip.
Unzip poky_win.zip.
Install MSVC Runtine.
Install by running poky_wininstall.bat in the uncompressed package.
Use C:\poky_win\bin\poky.bat
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)
Simpler approach would be,
Download poky_linux.zip.
Run poky_linuxinstall.sh from the uncompressed package.
Type poky in the terminal.
If you cannot run PokyAnalyzer, NDP-PLOT and EASY_UCSFDATA on Ubuntu 24.04, you can do following:
wget http://archive.ubuntu.com/ubuntu/pool/main/h/harfbuzz/libharfbuzz0b_2.7.4-1ubuntu3_amd64.deb
wget http://archive.ubuntu.com/ubuntu/pool/main/p/pango1.0/libpango-1.0-0_1.50.6+ds-2ubuntu1_amd64.deb
wget http://archive.ubuntu.com/ubuntu/pool/main/p/pango1.0/libpangoft2-1.0-0_1.50.6+ds-2ubuntu1_amd64.deb
wget http://archive.ubuntu.com/ubuntu/pool/main/c/cairo/libcairo2_1.16.0-5ubuntu2_amd64.deb
sudo dpkg -i *.deb
Make sure you have apptainer or singularity installed.
Build a POKY container:
wget https://poky.clas.ucdenver.edu/poky_releases/poky.def
(As an administrator) apptainer build poky.sif poky.def
or
(As a regular user) apptainer 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:
apptainer run /path/to/poky.sif
Use --writable flag after run if necessary.
apptainer run --writable /path/to/poky.sif
If you encouter a permission problem, you can add docker group to the user account.
(if the docker group doesn't exist) sudo groupadd docker
sudo usermod -aG docker <user name>
Then logout and in.
if the "failed to create mount namespace...." error occurs, do this.
sudo sysctl -w kernel.apparmor_restrict_unprivileged_userns=0
If some windows remain after quitting POKY:
pkill -9 poky
If you see a message "could not connect to display :0", try this.
xhost +local:apptainer
For your convenience, you can alias the command (e.g. alias poky='apptainer run --writable /path/to/poky.sif' in .bash_aliases).
The installation path should have neither spaces nor special characters.