pi-pm3/DOCKER_SETUP.md

Docker Setup for Pi-gen Builds

Current Situation

You need Docker access to build Raspberry Pi images, but you're not in the docker group.

Quick Fix (Requires Admin)

Ask someone with sudo access to run:

sudo usermod -aG docker work

Then YOU run:

# Refresh your groups (pick one)
newgrp docker           # Option 1: New shell with updated groups
# OR
exit                    # Option 2: Log out and back in

Verify it works:

docker ps               # Should work without "permission denied"

Current Docker Group Members

docker:x:984:michael

User michael is in the docker group - they may be able to help or know who can.

After Docker Access is Granted

You can then build your image with:

cd /home/work/pi-gen-builder
./build-docker.sh

Or use the helper script:

cd /home/work/dangerous-pi
./build-image.sh full

Alternative: GitHub Actions (No Local Docker Needed)

If you can't get local Docker access, we can set up automated builds using GitHub Actions.

Advantages

• ✅ No local Docker required
• ✅ Free for public repos
• ✅ Builds run in the cloud
• ✅ Automatic on every push
• ✅ Download built images as artifacts

Setup

Would create .github/workflows/build-image.yml that:

1. Checks out your code
2. Runs pi-gen build in GitHub's Docker environment
3. Uploads the resulting image as a downloadable artifact

Build time: ~1-2 hours in GitHub Actions Cost: Free (public repos get 2000 minutes/month)

Let me know if you want me to create the GitHub Actions workflow!

Alternative: Cloud VM (Temporary)

If you need to build NOW and can't wait for permissions:

Option 1: Oracle Cloud (Free Tier)

# Create free ARM VM
# SSH in and run:
git clone https://github.com/RPi-Distro/pi-gen.git pi-gen-builder
cd pi-gen-builder && git checkout arm64
# Copy your files and build

Option 2: DigitalOcean

# $5/month droplet (destroy after build)
# Similar setup

Option 3: AWS EC2

# t2.micro (free tier eligible)

Summary

Fastest solution: Ask someone with sudo to add you to docker group (1 minute)

No-permission solution: GitHub Actions (30 minutes to set up, then automatic)

Alternative: Build on cloud VM (requires account setup)

---

Current Status: ⏸️ Waiting for Docker group access

Blocker: Need sudo usermod -aG docker work to be run

Who can help: User michael or system administrator