How do I make my local GitHub Actions runs faster?

Use the --reuse flag to avoid recreating containers between runs, select smaller base images like alpine-based runners, and utilize the --parallel flag for concurrent job execution.

How do I fix Docker socket permission errors in act?

You can configure the socket in your .actrc file using --container-daemon-socket - (for default) or explicitly pointing to the Docker Desktop socket path on your machine.

Which Docker image should I use for act?

For most workflows, catthehacker/ubuntu:act-latest is the standard choice. Use 'full' versions for complex builds requiring many tools, or language-specific slim images for maximum speed.

Can I run act on an M1/M2/M3 Mac?

Yes, you should specify the architecture using the --container-architecture linux/arm64 flag in your configuration to ensure compatibility with Apple Silicon.

Act Docker Configuration

Name: Act Docker Configuration
Author: TheBushidoCollective

byTheBushidoCollective

•

Deployment & DevOps

Configures and optimizes Docker environments for local GitHub Actions testing using act.

This skill provides expert guidance for setting up and managing Docker containers used by act to run GitHub Actions workflows locally. It simplifies the process of selecting the right runner images—ranging from micro Node.js images to full Ubuntu environments—while managing resource limits, persistent volumes, and security capabilities. Whether you are optimizing performance on Apple Silicon or debugging complex multi-platform builds, this skill ensures a consistent, professional, and efficient local CI/CD environment that mirrors GitHub's production runners.

Key Features

01Automated selection of optimized Docker runner images based on workflow needs

0295 GitHub stars

03Resource optimization including CPU/Memory limits and container reuse patterns

04Persistent configuration management via .actrc and environment files

05Comprehensive troubleshooting for socket permissions, DNS, and volume mounting issues

06Cross-platform support for Linux/AMD64 and Apple Silicon (ARM64) architectures

Use Cases

01Debugging environment-specific workflow failures that only occur in containerized runners

02Setting up a high-performance local GitHub Actions testing environment

03Optimizing CI/CD build speeds by switching to language-specific Docker runners

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add thebushidocollective/han act-docker-setup

For use in Claude.ai and ChatGPT

Download Skill