What this covers
A static site is any site where all files are pre-built: HTML pages, CSS stylesheets, and JavaScript bundles. The platform serves these files directly via nginx. There is no database, no server process, and no runtime to configure. Ideal for landing pages, portfolios, documentation sites, and front-end apps that talk to an external API.
Before you start
Build your site locally first (for example with npm run build, vite build, or hugo) and push the output to a GitHub repository. The repo must contain a dist/, build/, out/, or public/ folder with an index.html inside. If no subfolder exists, index.html in the root is used. Public and private repositories both work. For a private one, create a GitHub token with the repo scope and paste it into the GitHub token field when you deploy; leave that field empty for a public repository.
How to do it
- Want to see it work first? Deploy our static starter from the public repository https://github.com/cirro-admin/cmcloudhosting-demo with Subdirectory static and Runtime static. Its README lists every field, and once it runs you have a working reference for your own app.
- Purchase an App Hosting plan from the portal, or start a free 5-day trial from the Services page.
- Push your built static files to a GitHub repository. Make sure index.html is inside a dist/, build/, out/, or public/ subfolder (or at the root).
- Navigate to Portal → Services and open your App Hosting service.
- In the Deploy App section, set Action to Deploy Static app and Runtime to static.
- Paste your GitHub repository URL (https://github.com/you/repo) into the Artifact Reference field.
- Leave the build and start command fields empty — the platform detects your output folder automatically.
- Click Redeploy App and wait up to 60 seconds for deployment to complete.
- Your site is live at your assigned domain. No database is provisioned for static sites.
Starter code and references
What our team checks
Support verifies the repository URL is accessible, the output folder is detected correctly, and nginx is serving your files without errors.
Next step
Push your build output to GitHub, then open the deploy form on your service page.