You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
description: Common issues and solutions for DeployStack MCP Serverdeployments
4
+
sidebar: Troubleshooting
5
+
---
6
+
7
+
# Troubleshooting DeployStack
8
+
9
+
Under this section, we will cover common issues and solutions for DeployStack MCP Server deployments. If you encounter any problems, please refer to the following troubleshooting steps.
Copy file name to clipboardExpand all lines: docs/docker-deployment/deploystack-config-file.mdx
+2-2Lines changed: 2 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -56,7 +56,7 @@ The override process follows this order:
56
56
57
57
### Branch Deployment Settings
58
58
59
-
Before configuring multiple branch deployments, ensure you have installed the [DeployStack Repository Sync GitHub App](/deploystack/github-application), as it's required for branch monitoring and template updates.
59
+
Before configuring multiple branch deployments, ensure you have installed the [DeployStack Repository Sync GitHub App](/docker-deployment/github-application), as it's required for branch monitoring and template updates.
60
60
61
61
You can configure multiple branch deployments using the `deployment.branches` section:
62
62
@@ -256,4 +256,4 @@ deployment:
256
256
257
257
### Minimal Configuration example for logo update
258
258
259
-
Please visit our [Application Logo Configuration](/deploystack/application-logo-configuration) page.
259
+
Please visit our [Application Logo Configuration](/docker-deployment/application-logo-configuration) page.
Copy file name to clipboardExpand all lines: docs/docker-deployment/deploystack-configuration-directory.mdx
+6-6Lines changed: 6 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -5,7 +5,7 @@ description: Technical guide for setting up the .deploystack directory to manage
5
5
6
6
# .deploystack Directory Reference
7
7
8
-
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](/deploystack/iac-lifecycle). The deploystack configurations repo only makes sense if you also [install DeployStack GitHub app](/deploystack/github-application). Otherwise, changes to DeployStack backend will not be recognized.
8
+
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](/docker-deployment/iac-lifecycle). The deploystack configurations repo only makes sense if you also [install DeployStack GitHub app](/docker-deployment/github-application). Otherwise, changes to DeployStack backend will not be recognized.
9
9
10
10
<Callout>
11
11
`.deploystack` directory is optional. You don't need to create it to submit your repository to deploystack.io.
@@ -24,7 +24,7 @@ The `.deploystack` directory in your repository contains configuration files tha
24
24
25
25
### DeployStack Configuration File
26
26
27
-
Please read more at [DeployStack Configuration File Reference](/deploystack/deploystack-config-file).
27
+
Please read more at [DeployStack Configuration File Reference](/docker-deployment/deploystack-config-file).
28
28
29
29
### Docker Configuration
30
30
@@ -52,11 +52,11 @@ docker run -d -p 80:80 nginx:alpine
52
52
53
53
### Environment Variables
54
54
55
-
Please read more from our [environment variables](/deploystack/docker-environment-variables) page.
55
+
Please read more from our [environment variables](/docker-deployment/docker-environment-variables) page.
56
56
57
57
## Automatic Updates
58
58
59
-
When the [DeployStack GitHub App](/deploystack/github-application) is installed:
59
+
When the [DeployStack GitHub App](/docker-deployment/github-application) is installed:
60
60
61
61
1. Changes to specific (`docker-compose.yml` & `docker-run.txt`) file in `.deploystack/` trigger template updates
62
62
2. Updates only process when changes occur on the default branch
@@ -66,6 +66,6 @@ When the [DeployStack GitHub App](/deploystack/github-application) is installed:
66
66
67
67
- The `.deploystack` directory is **optional**
68
68
- Without this directory, automatic template updates are **not** available
69
-
- You can add the directory and install the [DeployStack GitHub Sync App](/deploystack/github-application) at any time
70
-
- [Environment variables](/deploystack/docker-environment-variables) and [DeployStack config](/deploystack/deploystack-config-file) are optional components
69
+
- You can add the directory and install the [DeployStack GitHub Sync App](/docker-deployment/github-application) at any time
70
+
- [Environment variables](/docker-deployment/docker-environment-variables) and [DeployStack config](/docker-deployment/deploystack-config-file) are optional components
71
71
- Only one Docker configuration file should be used (either compose or run)
Copy file name to clipboardExpand all lines: docs/docker-deployment/github-application.mdx
+5-5Lines changed: 5 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -11,7 +11,7 @@ The DeployStack GitHub App ensures your Infrastructure as Code (IaC) templates r
11
11
12
12
When you install the [DeployStack Repository Sync](https://github.com/apps/deploystack-repository-sync) app, it monitors specific files in your repository:
13
13
14
-
-`.deploystack/` directory - [Contains your Docker configurations and assets](/deploystack/deploystack-configuration-directory)
14
+
-`.deploystack/` directory - [Contains your Docker configurations and assets](/docker-deployment/deploystack-configuration-directory)
15
15
-`README.md` - For README.md updates
16
16
17
17
When changes are detected in these files, the app automatically triggers an update of your IaC templates in our [deploy-templates](https://github.com/deploystackio/deploy-templates) repository.
@@ -47,12 +47,12 @@ When the app detects changes, it automatically updates:
47
47
- Repository Homepage
48
48
- Description
49
49
- IaC templates
50
-
- Depends on which technique (docker compose or docker run command) you choose, you can upload the `docker-compose.yml` or `docker-run.txt` in the `.deploystack` directory. Every time you update the files on your main branch (or additional branch), IaC templates will be updated automatically - [Automatic Updates](/deploystack/deploystack-configuration-directory#automatic-updates).
50
+
- Depends on which technique (docker compose or docker run command) you choose, you can upload the `docker-compose.yml` or `docker-run.txt` in the `.deploystack` directory. Every time you update the files on your main branch (or additional branch), IaC templates will be updated automatically - [Automatic Updates](/docker-deployment/deploystack-configuration-directory#automatic-updates).
51
51
- Environment variables
52
-
- To make it easier for a user to deploy IaC templates, it is recommended to work with environment variables. For this purpose, you can upload an `env` file and add your appropriate variables - [Environment Variables](/deploystack/deploystack-configuration-directory#environment-variables).
52
+
- To make it easier for a user to deploy IaC templates, it is recommended to work with environment variables. For this purpose, you can upload an `env` file and add your appropriate variables - [Environment Variables](/docker-deployment/deploystack-configuration-directory#environment-variables).
53
53
- DeployStack Configuration
54
54
- Project / Applicaton Logo
55
-
- It is possible to upload your own logo to DeployStack catalog. To do this you need to upload a file to our directory `.deploystack`. Read more about it here: [Repository Logo](/deploystack/deploystack-configuration-directory#repository-logo)
55
+
- It is possible to upload your own logo to DeployStack catalog. To do this you need to upload a file to our directory `.deploystack`. Read more about it here: [Repository Logo](/docker-deployment/deploystack-configuration-directory#repository-logo)
56
56
57
57
## Managing the Integration
58
58
@@ -66,4 +66,4 @@ After installing the app:
66
66
2. Commit and push your changes
67
67
3. DeployStack will automatically update your deployment templates
68
68
69
-
For details about the `.deploystack` directory structure, check our [.deploystack Directory Reference](/deploystack/deploystack-configuration-directory).
69
+
For details about the `.deploystack` directory structure, check our [.deploystack Directory Reference](/docker-deployment/deploystack-configuration-directory).
Copy file name to clipboardExpand all lines: docs/docker-deployment/iac-lifecycle.mdx
+3-3Lines changed: 3 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -11,7 +11,7 @@ This guide explains how DeployStack manages and updates your Infrastructure as C
11
11
12
12
### Initial Setup
13
13
14
-
1. Create a `.deploystack`[configuration directory](/deploystack/deploystack-configuration-directory) in your repository
14
+
1. Create a `.deploystack`[configuration directory](/docker-deployment/deploystack-configuration-directory) in your repository
15
15
2. Add your Docker configuration files:
16
16
-`docker-compose.yml` for Compose configurations
17
17
-`docker-run.txt` for Docker run commands
@@ -20,7 +20,7 @@ This guide explains how DeployStack manages and updates your Infrastructure as C
20
20
21
21
### Enabling Automatic Updates
22
22
23
-
Install the [DeployStack Repository Sync](/deploystack/github-application) GitHub App to keep your templates up to date when:
23
+
Install the [DeployStack Repository Sync](/docker-deployment/github-application) GitHub App to keep your templates up to date when:
24
24
25
25
- You modify Docker configurations in the `.deploystack` directory
26
26
- Cloud providers update their IaC specifications
@@ -36,7 +36,7 @@ All IaC templates are stored in public and open-source repository: [https://gith
36
36
37
37
### Prerequisites for activating the flow
38
38
39
-
1. You have installed the [DeployStack GitHub app](/deploystack/github-application).
39
+
1. You have installed the [DeployStack GitHub app](/docker-deployment/github-application).
40
40
2. You have created the `.deploystack/docker-run.txt` or `.deploystack/docker-compose.yml` file.
41
41
42
42
The choice between `docker-run.txt` or `docker-compose.yml` depends on the submission process used to DeployStack. When submitting to DeployStack, you can choose two methods -> Docker Run or Docker Compose.
0 commit comments