How do I make my act settings permanent?

You can create a .actrc file in your project root to store persistent flags like platform mappings (-P), resource limits, and architecture settings.

How can I fix permission issues in act containers?

The skill provides patterns for mapping host user IDs to the container using --container-options to prevent workspace permission errors.

What runner images are recommended for act?

The skill suggests catthehacker/ubuntu images for general use, node:alpine for lightweight workflows, and full-latest images when maximum tool compatibility is required.

Does this skill help with Apple Silicon Mac compatibility?

Yes, it provides specific commands for setting the --container-architecture to linux/arm64 to ensure Docker containers run correctly on M1/M2/M3 chips.

Act Docker Setup

Name: Act Docker Setup
Author: TheBushidoCollective

byTheBushidoCollective

•

Deployment & DevOps

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

About

This skill provides specialized guidance for managing the Docker layer of act, the tool for running GitHub Actions locally. It helps developers select the right runner image size (from micro to full), configure persistent settings via .actrc, manage container lifecycles, and handle complex volume mounts. Whether you are troubleshooting container networking, optimizing resource limits, or setting up multi-platform builds, this skill ensures your local CI/CD environment accurately mirrors production while maintaining high performance.

Key Features

Persistent configuration management via .actrc and environment files
Advanced volume mounting and persistent cache configuration
Container lifecycle management including cleanup and inspection
39 GitHub stars
Runner image selection for Micro, Medium, and Large use cases
Architecture-specific settings for Apple Silicon and Linux environments

Use Cases

Debugging permission and networking issues within act containers
Setting up a performant local GitHub Actions testing environment
Optimizing CI/CD speed by selecting language-specific runner images

About

Key Features

Persistent configuration management via .actrc and environment files
Advanced volume mounting and persistent cache configuration
Container lifecycle management including cleanup and inspection
39 GitHub stars
Runner image selection for Micro, Medium, and Large use cases
Architecture-specific settings for Apple Silicon and Linux environments

Use Cases

Debugging permission and networking issues within act containers
Setting up a performant local GitHub Actions testing environment
Optimizing CI/CD speed by selecting language-specific runner images