How do I add my own application to Awesome Stacks?

You need to create a custom Docker stack YAML file by studying existing stacks in the repository, as it only includes pre-built configurations. Ensure it integrates with Traefik and follows the same environment variable patterns for consistency.

Awesome Stacks vs Kubernetes: which is better for self-hosting?

Awesome Stacks is simpler and faster for Docker Swarm-based deployments with minimal setup, while Kubernetes offers more scalability and features for complex, production-ready environments. Choose based on your technical comfort and scale requirements.

How to update apps deployed with Awesome Stacks?

Update the version environment variable in the deploy command, then redeploy the stack. For instance, use VERSION=latest in the docker stack deploy command, as shown in the customization section for Ghost.

Does Awesome Stacks support multi-node Docker Swarm clusters?

Yes, it can deploy to multi-node clusters since it uses Docker Swarm stacks, but you must set up Docker Swarm correctly and ensure network and volume configurations are compatible across nodes.

How to backup data when using Awesome Stacks?

Data persistence relies on Docker volumes; back up the volume paths specified in the stack YAML files. Use standard Docker volume backup methods, as Awesome Stacks doesn't include built-in backup solutions.

Troubleshooting Traefik not issuing SSL certificates in Awesome Stacks?

Verify Traefik is deployed correctly and the domain env var is set properly. Ensure DNS records point to your server and ports 80/443 are accessible, as Traefik requires this for Let's Encrypt validation.

Can I use Awesome Stacks without installing Traefik separately?

No, Traefik is a prerequisite and must be deployed first, as stated in the requirements. The README provides commands to set it up, but this adds an initial setup step beyond the app stacks.

Open-Awesome

awesome-stacks

GPL-3.0Dockerfile

Deploy 150+ open-source web applications with a single Docker command using pre-configured Docker Swarm stacks.

Visit Website GitHub

1.3k stars162 forks0 contributors

What is awesome-stacks?

Awesome Stacks is a repository of Docker Swarm stack configurations for deploying over 150 open-source web applications like Nextcloud and Ghost. It solves the complexity of manually configuring and deploying self-hosted services by providing pre-built, customizable stacks that work with one command.

Target Audience

Developers, homelab enthusiasts, and small teams looking to self-host web applications quickly without extensive DevOps configuration.

Value Proposition

Developers choose Awesome Stacks for its zero-configuration approach and extensive library of ready-to-deploy apps, reducing deployment time from hours to minutes while maintaining customization flexibility.

Overview

Deploy 150+ open-source web apps with one Docker command

Use Cases

Best For

Rapidly deploying self-hosted applications like Nextcloud or Ghost
Setting up a homelab with multiple web services using Docker Swarm
Learning Docker Swarm with practical, pre-configured examples
Automating SSL certificate management with Traefik and Let's Encrypt
Managing deployments through Portainer with provided templates
Customizing application domains and versions via environment variables

Not Ideal For

Projects requiring Kubernetes orchestration for advanced scalability and enterprise features
Environments with strict compliance or security policies needing fully customizable, auditable configurations
Teams deploying proprietary or niche applications not included in the 150+ pre-built stacks
Large-scale production deployments requiring integrated monitoring, logging, or CI/CD pipelines

Pros & Cons

Pros

One-Command Deployment

Deploy any of over 150 apps with a single docker stack deploy command, as shown in the README with examples like Nextcloud, drastically reducing setup time.

Automatic SSL Security

Integrates Traefik to automatically secure apps with Let's Encrypt SSL certificates, eliminating manual certificate management and ensuring HTTPS by default.

Environment Variable Customization

Customize domains, versions, and volume paths using environment variables, demonstrated in the Ghost deployment example for flexible adaptation.

Portainer Web Interface Support

Includes templates.json for deploying stacks through Portainer's GUI, adding a user-friendly option beyond CLI, as highlighted in the features.

Cons

Docker Swarm Dependency

Requires Docker Swarm setup and initialization, adding complexity for users unfamiliar with Swarm or preferring other orchestrators like Kubernetes.

Limited Configuration Depth

Zero-config approach uses sensible defaults but restricts advanced tweaks; customization is limited to env vars, lacking support for deep stack modifications.

Static Stack Maintenance

Stacks are pre-configured and static; users must manually update app versions or configurations, risking obsolescence without active upkeep from the project.

Frequently Asked Questions

Related Projects

werf

A solution for implementing efficient and consistent software delivery to Kubernetes facilitating best practices.

Build and deploy docker images to Kubernetes using git push

Stars3,847

Forks197

Last commit3 years ago

Grafeas

Artifact Metadata API

Stars1,571

Forks308

Last commit28 days ago

Clocker

Apache Brooklyn cloud native infrastructure blueprints

Stars429

Forks64

Last commit7 years ago

Community-curated · Updated weekly · 100% open source

Found a gem we're missing?

Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.

Submit a project Star on GitHub