diff --git a/docs/custom-apps.md b/docs/custom-apps.md index f33aa3c7d..a3d4ef6c6 100644 --- a/docs/custom-apps.md +++ b/docs/custom-apps.md @@ -34,6 +34,18 @@ You can also generate base64 string from json file: export APPS_JSON_BASE64=$(base64 -w 0 /path/to/apps.json) ``` +Test the Previous Step: Decode the Base64-encoded Environment Variable + +To verify the previous step, decode the APPS_JSON_BASE64 environment variable (which is Base64-encoded) into a JSON file. Follow the steps below: + +1. Use the following command to decode and save the output into a JSON file named apps-test-output.json: + +```shell +echo -n ${APPS_JSON_BASE64} | base64 -d > apps-test-output.json +``` + +2. Open the apps-test-output.json file to review the JSON output and ensure that the content is correct. + Note: - `url` needs to be http(s) git url with personal access tokens without username eg:- http://{{PAT}}@github.com/project/repository.git in case of private repo. diff --git a/docs/error-nginx-entrypoint-windows.md b/docs/error-nginx-entrypoint-windows.md new file mode 100644 index 000000000..7be1c2ca5 --- /dev/null +++ b/docs/error-nginx-entrypoint-windows.md @@ -0,0 +1,12 @@ +# Resolving Docker `nginx-entrypoint.sh` Script Not Found Error on Windows + +If you're encountering the error `exec /usr/local/bin/nginx-entrypoint.sh: no such file or directory` in a Docker container on Windows, follow these steps to resolve the issue. + +## 1. Check Line Endings + +On Windows, files often have `CRLF` line endings, while Linux systems expect `LF`. This can cause issues when executing shell scripts in Linux containers. + +- **Convert Line Endings using `dos2unix`:** + ```bash + dos2unix resources/nginx-entrypoint.sh + ```