.deploystack Directory Reference

The .deploystack directory in your repository contains configuration files that DeployStack uses to generate and maintain your Infrastructure as Code templates. Creating this repo allows you to enable the lifecycle of IaC. The deploystack configurations repo only makes sense if you also install DeployStack GitHub app. Otherwise, changes to DeployStack backend will not be recognized.

Directory Structure

.deploystack/
├── docker-compose.yml  # Docker Compose configuration
├── docker-run.txt      # Docker run command
├── env                 # Environment variables (optional)

Configuration Files

DeployStack Configuration File

Please read more at DeployStack Configuration File Reference.

Docker Configuration

Choose one of the following:

• docker-compose.yml - Standard Docker Compose configuration
• docker-run.txt - Single Docker run command

Example docker-compose.yml:

version: '3'
services:
  web:
    image: nginx:alpine
    ports:
      - "80:80"

Example docker-run.txt:

docker run -d -p 80:80 nginx:alpine

Environment Variables

Please read more from our environment variables page.

Automatic Updates

When the DeployStack GitHub App is installed:

1. Changes to specific (docker-compose.yml & docker-run.txt) file in .deploystack/ trigger template updates
2. Updates only process when changes occur on the default branch
3. New templates are generated and stored in the deploy-templates repository

Important Notes

• The .deploystack directory is optional
• Without this directory, automatic template updates are not available
• You can add the directory and install the DeployStack GitHub Sync App at any time
• Environment variables and DeployStack config are optional components
• Only one Docker configuration file should be used (either compose or run)