4f35df1781
🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
116 lines
2.5 KiB
Markdown
116 lines
2.5 KiB
Markdown
# 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:**
|
|
|
|
```bash
|
|
sudo usermod -aG docker work
|
|
```
|
|
|
|
**Then YOU run:**
|
|
|
|
```bash
|
|
# 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:**
|
|
|
|
```bash
|
|
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:
|
|
|
|
```bash
|
|
cd /home/work/pi-gen-builder
|
|
./build-docker.sh
|
|
```
|
|
|
|
Or use the helper script:
|
|
|
|
```bash
|
|
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)
|
|
```bash
|
|
# 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
|
|
```bash
|
|
# $5/month droplet (destroy after build)
|
|
# Similar setup
|
|
```
|
|
|
|
### Option 3: AWS EC2
|
|
```bash
|
|
# 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
|