GreenStack
Guides for the GreenStack platform.
- Are there delays when deploying to a replicated GreenStack service?Yes, the system will wait 5 minutes between deploying to servers, this is to ensure that your website is running and stable before it moves on to deploy
- Can I automatically trigger my GreenStack deployment?Yes, using the Webhook you can trigger a deployment after your CI/CD build has completed successfully. Below is an example task you can add to your GitHub
- Can I have terminal access to my GreenStack container?Yes. Click Open Terminal under Running Tasks on Manage Websites in UmbPanel. The terminal is for debugging only: changes don't persist.
- Getting Started with Umbraco 13 on GreenStack with GitHubStep-by-step guide to deploying Umbraco 13 to GreenStack with GitHub Actions: start from a template or starter kit, or add GreenStack support to an existing project.
- Getting Started with Umbraco 17 on GreenStack with GitHubStep-by-step guide to deploying Umbraco 17 to GreenStack with GitHub Actions: start from a template or starter kit, or add GreenStack support to an existing project.
- GreenStack Starter Azure DevOps PipelinesYou can find a starter Azure DevOps Pipelines in our samples GitHub repository linked below; you are free to add your frontend build steps to the file
- GreenStack Starter DockerfileYou will need to add our Dockerfile to your project, we have pre-configured this for our GreenStack platform. If you customise the file, please leave the
- GreenStack Starter GitHub Actions WorkflowsYou can find a starter GitHub Actions Workflows in our samples GitHub repository linked below; you are free to add your frontend build steps to the file
- How do I add a health check endpoint to my GreenStack site?Add ASP.NET Core's built-in health checks at /health, then set /health as your service's healthcheck path in UmbPanel so GreenStack only sends traffic to replicas that are ready.
- How do I configure SignalR when running multiple GreenStack replicas?When a GreenStack site is scaled to 2 or more replicas, the Umbraco back office needs a shared SignalR backplane. This guide points you at the 'using existing infrastructure' approach from the Umbraco docs.
- How do I exclude UmbPanel domains from www redirects?A www redirect that rewrites the host breaks access via the umbpanel.io preview URL and fails GreenStack's load balancer health checks. Exclude all *.umbpanel.io domains from the redirect, with IIS rewrite and Program.cs examples.
- How do I fix the HTTPS Health Check for GreenStack?The health check must be removed via configuration, through the appsettings.json file, environment variables, or similar. The HstsCheck key is
- How do I fix the Runtime mode validator for GreenStack?The UseHttpsValidator must be removed through code. The code to remove the validator can look something like: using Umbraco.Cms.Core.Composing; using
- How should I configure Examine for GreenStack?When deploying Umbraco to GreenStack, it is important to ensure that not all files are stored in the file share- otherwise you will experience file
- How to Forward HTTPS headersOur GreenStack platform offloads SSL / HTTPS connections at the loadbalancer, this means that your site won't see the HTTPS connection by default. Simply
- How to I access my GreenStack persisted files?Create an SFTP user in UmbPanel, then use the File Manager in your browser or connect with any SFTP client.
- How to persist .NET Data Protection keysThere are a number of ways to persist .NET Data Protection keys, this article explains how to persist the keys to disk on our GreenStack platform. If you
- I want to use SQLite or an external database, how do I do this?GreenStack manages your database connection string, so it can't be changed in UmbPanel. Open a support ticket if you need SQLite or an external database.
- Is there a Webhook to automatically trigger the release?Yes. Your webhook URL is under Webhook Details on Manage Websites in UmbPanel. Send an empty POST request to it to deploy the latest image.
- Is there FTP or WebDeploy access to GreenStack persisted files?No. GreenStack uses SFTP instead: create an SFTP user in UmbPanel, then use the File Manager or any SFTP client.
- My site is showing Page Not Found after deploymentGreenStack runs on Linux containers, which are case-sensitive. The two most common causes are mismatched View filename casing and a missing hostname on the root content node.
- Using AI assistants with GreenStackUse the official GreenStack Claude skill and UmbPanel MCP server to configure, deploy and manage Umbraco on GreenStack with an AI assistant.
- What Docker registries does GreenStack support?GreenStack supports the below registries: DockerHub Azure Container Registry GitLab Container Registry GitHub Container Registry AWS ECR ProGet Quay
- What does the UmbHost GreenStack NuGet package do?UmbHost.GreenStack.Umbraco.Configuration sets up an Umbraco 13 or 17 site to run on GreenStack: forwarded headers, HTTPS checks, Data Protection keys, view publishing and, for 2 or more replicas, load balancing. Install it and redeploy.
- Why can't I see my GreenStack logs UmbPanel?Overview If you're unable to see logs in the UmbPanel log viewer, or the log view appears empty, this is typically because your Umbraco application is
- Why do new pages 404 after a deploy on a replicated GreenStack site?On an Umbraco 17 GreenStack site with 2 or more replicas, pages you publish can work at first, then return a 404 after the next deploy or restart until you republish them. This explains why and how to fix it.
- Why does my GreenStack site take a long time to boot?Long boot times on GreenStack are usually caused by the default .NET file watcher. Setting the DOTNET_USE_POLLING_FILE_WATCHER environment variable to true