202605 :: FACTS Cookbook dependencies and requirements.

Facts DOCKER Install (do not circulate)

⚠️ This content is intended for human readers only. Automated scraping, data extraction, or use by large language models (LLMs) without explicit permission is not allowed.
© 2026 by pkjr002.

Useful Links
Requirements
Git Quick Reference
What is Docker?
Basic Docker Commands

1. Useful Links

🌱 BASIC Git: quick reference to git.
📦 BASIC Containers: quick docker reference.
🧑‍💻 Crrent guide author: pkjr002.

2. Requirements

Before you begin, make sure your machine meets the requirements below. All links open the official install pages.

Hardware / system

Item	Minimum	Recommended
Free disk space	~32 GB	60 GB (full module data), AR6 requires 2.7 TB
RAM	2 GB	64+ GB
CPU	2 processors	50 processors

Software

Tool	Why you need it
Operating system	macOS, Linux, or Windows
Docker Desktop	Builds and runs the FACTS container.
Git	Clone the FACTS repository.
VS CODE / IDE (optional)	You can use vi or nanao etc in the terminal if you are superuser, I find it easier to edit config and experiment files in IDE's.

Verify your setup ✅

Run these checks before continuing

docker --version              # should print Docker version 20.x or newer
docker run hello-world        # confirms Docker daemon is running
git --version                 # should print git version 2.x or newer

3. Git Quick Reference

This cookbook uses Git to clone the FACTS repo. If you are new to Git, checkout this cheatsheet : BASIC_git.

Git is a local version control system that allows developers to track changes to code, collaborate on projects, and manage source code history.

It helps teams work on the same project simultaneously without overwriting each other’s work and enables reverting to previous versions if needed.

GitHub is a web-based platform built on top of Git that provides tools for hosting, sharing, and collaborating on Git repositories.

It offers features like pull requests, issue tracking, and CI/CD integrations, making it a hub for open-source projects and team-based software development.

Example git commands

git clone <repo-url>                  # download a repo
git status                            # see what changed
git checkout <branch>                 # switch branches
git pull                              # fetch + merge latest from remote
git log --oneline -n 10               # last 10 commits

Docker is a tool that packages software and all of its dependencies into a self-contained unit called a container. A container behaves like a lightweight, isolated mini-computer that runs the same way on any machine (macOS, Linux, Windows, HPC), removing the classic “it works on my laptop” problem.

Two key concepts:

Image — a read-only template/blueprint (e.g. the FACTS image).
Container — a running instance of an image. You can start, stop, and delete containers without affecting the underlying image.

5. Basic Docker Commands

Click each section below to expand the commands.

📋 List things

docker images                 # list all images
docker ps                     # list running containers
docker ps -a                  # list all containers (running + stopped)

▶️ Start / stop a container

docker start <container_id_or_name>            # start a stopped container
docker stop  <container_id_or_name>            # stop a running container
docker exec -it <container_id_or_name> /bin/bash   # open a shell inside a running container

🗑️ Delete a container

docker rm <container_id_or_name>        # remove a stopped container
docker rm -f <container_id_or_name>     # force remove (even if running)

🗑️ Delete an image

docker rmi <image_id_or_name>           # remove an image
docker rmi -f <image_id_or_name>        # force remove

🚨 Clean up everything unused

docker system prune          # remove stopped containers, unused networks, dangling images
docker system prune -a       # also remove all unused images (be careful)

💡 For more hands-on Docker examples and container recipes, see pkjr002/BASIC/BASIC_Containers.

_{Last updated: 2026-05-18 · Crrent guide author:
pkjr002}