This video presents how to install Poky on Mac in old way. So only refer if the following does not work. Poky requires the installation of XQuartz.app that you can find the link from the download page.
Download and unzip poky_mac.zip.
Download and install XQuartz 2.8.6 or newer. MacOS Tahoe has some glitches.
Drag poky.app from the unzipped folder into /Applications. If an older POKY is already there, choose Replace.
Open poky.app from /Applications. POKY is code-signed and notarized by Apple, so on first launch macOS only asks you to confirm opening an application downloaded from the Internet. Click Open.
Under System Preferences > Security & Privacy > Full Disk Access > add poky.app and XQuartz.app
Depending on your setup, the following components may also need access: sh, launchd_startx, PokyAnalyzer.app, easy_ucsfdata.app, and ndpplot.app.
Versions between XQuartz 2.8.5 beta 3 and 2.8.6 beta 2 have a flaw in drawing. Use 2.8.6 beta 3 or newer.
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 in old way. So only refer if the following does not work.
Simpler approach would be,
Download poky_linux.zip.
Run poky_linuxinstall.sh from the uncompressed package.
Type poky in the terminal.
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.