nasapsg/psg-amd repository overview

Detailed information into how to operate PSG Docker system is available at https://psg.gsfc.nasa.gov/helpapi.php⁠

Please follow these steps to install PSG Docker on your machine

1. Install the free Docker Engine on your machine. If in Linux, this can by simply done by performing a 'yum install docker' in Centos/RHEL or with apt-get on Debian and others (more info):

yum install docker
sudo systemctl start docker

In Macs or in Windows, you would need to install the free Rancher Desktop application on your computer. This is relatively easy and it will establish a virtualization system in which PSG will run. When installing, make sure to select 'dockerd (moby)' for the container runtime, 'Automatic' for path configuration, disable 'Kubernetes'. To avoid requiring 'sudo access' or administrative access to the app, please consider installing in your home applications directory not (/Applications). The application is downloadable at rancherdesktop.io.

1. From the command line / terminal, enter the following commands to pull the PSG container from the publicly available Docker hub repository:
   

For computers with Apple M1/M2 ARM chips
docker logout
docker pull nasapsg/psg
docker tag nasapsg/psg psg

For all other computers
docker logout
docker pull nasapsg/psg-amd
docker tag nasapsg/psg-amd psg

1. To run PSG and enable its API interface (add the keyword '--restart always' to keep PSG always running, even after re-booting):
   

docker run -d --name psg -p 127.0.0.1:3000:80 psg

1. To visit the local site of PSG, open your browser and go to http://localhost:3000⁠, while to run the local version of the Application-Program-Interface (API), enter the following command:
   

curl --data-urlencode file@psg_cfg.txt⁠ http://localhost:3000/api.php⁠

1. The user can install, upgrade and remove packages by visiting http://localhost:3000⁠. For performing this from the command line (e.g., inside a VM instance) follow these commands (where 'package' is the package name, all in lower case):
   

curl http://localhost:3000/index.php?install=package⁠
curl http://localhost:3000/index.php?update=package⁠
curl http://localhost:3000/index.php?remove=package⁠