kestr3l/opensatkit repository overview

⁠OpenSatKit Packed In a Docker Container

⁠0. Description

• This repository is for providing a docker image containing OpenSatKit(OSK)⁠ and minicom⁠ inside.
• Image is based on Ubuntu 18.04 due to dependency issues related to build of QT4 apps.
• Use of container will help resolving dependency matters caused by Ubuntu distro versions.
• Check Github repository⁠ for specific details and docker-compose.yml file

⁠1. How to run a container

• Use following command to run a container:
  • COSMOS will be launched
  • Minicom must be launched manually by: docker exec -it <CONTAINER_NAME> minicom -s

docker run -it --rm \
   -e DISPLAY=$DISPLAY \
   -e WAYLAND_DISPLAY=$WAYLAND_DISPLAY \
   -e QT_NO_MITSHM=1 \
   -e XDG_RUNTIME_DIR=$XDG_RUNTIME_DIR \
   -v /tmp/.X11-unix:/tmp/.X11-unix \
   --device /dev/ttyUSB0 \
   --net host \
   --ipc host \
   --gpus all \
   --privileged \
   --name OpenSatKit \
   kestr3l/opensatkit:18.04-v2.5-original

⁠2. List of Tags

• Available tags of images distributed by docker hub⁠ are as following:
  • Naming rule: <UBUNTU VERSION> - <OpenSatKit VERSION> - <VARIANT>

⁠3. References

1. OpenSatKit/OpenSatKit - github.com⁠
2. BallAerosapce/COSMOS - github.com⁠
3. Install Docker Engine on Ubuntu - docker docs⁠
4. Install the Compose standalone - docker docs⁠
5. XDG Base Directory Specification - freedesktop.org⁠