Frequently Asked Questions

What is configs.sh?

configs.sh is a free collection of web-based configuration generators for developers. Generate production-ready Docker Compose files, .dockerignore files, and other configs in seconds—no installation, no signup required. Instead of copying outdated snippets from Stack Overflow or reading through lengthy documentation, get a working config file with best practices built-in.

Is it really free? What's the catch?

Yes, completely free with no catch. There are no premium tiers, subscriptions, or feature paywalls. The site runs on Cloudflare Pages (which is free for this traffic level), and the goal is to build a useful tool for the developer community. No signup required, no email harvesting, no upsells.

Is my data stored or sent to any servers?

No. All configuration generation happens entirely in your browser using JavaScript. Nothing you enter (project names, environment variables, settings) is sent to any server or stored anywhere. The site is hosted as static files on Cloudflare Pages, with no backend database. You can verify this by checking your browser's network tab—you'll see no API calls during config generation.

Can I use these configs in production?

Yes. The generated configurations follow industry best practices and are production-ready. However, always review generated configs before deploying to production and adjust them to match your specific security requirements, resource constraints, and use case. Treat these as solid starting points, not final production configs that should never be modified.

How does the Docker Compose generator work?

The Docker Compose generator uses template-based generation with conditional logic. Based on your selections (databases, Redis, networking options), it assembles a docker-compose.yml file with proper syntax, health checks, volume mounts, and resource limits. The YAML is validated in real-time to catch syntax errors before you copy it.

How does the .dockerignore generator work?

The .dockerignore generator maintains language-specific exclusion patterns for Node.js, Python, Go, Rust, and Java. It knows which files to exclude for each ecosystem (node_modules, __pycache__, target/, etc.) and adds common patterns like .git, .env, and IDE config files. This reduces Docker build context size and improves security by preventing secrets from being copied into images.

What languages and frameworks are supported?

Currently supported: Node.js, Python, Go, Rust, and Java for the .dockerignore generator. The Docker Compose generator supports PostgreSQL, MySQL, MongoDB, Redis, and custom application services. More languages and tools are on the roadmap, including Nginx configs, systemd service files, and GitHub Actions workflows.

Do I need to install anything?

No installation needed. Everything runs in your web browser. Just visit the site, select your options, and copy the generated config. No CLI tools, no npm packages, no dependencies to manage.

How is this different from other config generators?

Most config generators are CLI tools that require installation, or they're bloated web apps with dozens of options. configs.sh focuses on simplicity: web-based (no install), minimal UI, and opinionated defaults based on best practices. You get a working config in seconds, not minutes of configuration.

Can I contribute or request features?

Yes! The project is on track to be open sourced in version 1.0. Until then, you can contribute by reporting bugs, suggesting new generators, or requesting features. Check the roadmap to see what's planned and add your vote to feature requests.