Choose a workflow based on where your files are. Use the browser to inspect and edit a project before publishing, or the CLI to deploy files you maintain locally.
Deploy from the browser
- Choose Import Project on the homepage.
- Paste HTML or upload the complete folder or ZIP.
- Review the editor preview and fix missing files or broken links.
- Click Publish, complete any account prompts and open the confirmed live address.
Importing does not itself publish. For screenshots of the example project, asset paths and Free-plan limits, see how to host an HTML file.
Deploy from the terminal
With Node.js and npm installed, run:
npm install -g htmlhost-cli
htmlhost login
cd path/to/your/project
htmlhost deploy .Approve the browser sign-in code, then return to the terminal. Directory deployment includes HTML pages and their assets; no --pages flag is needed. Start with the example project ZIP if you do not have a site yet.
Working in VS Code, Cursor or Windsurf? The free htmlhost extension runs the same deploy from a button: see how to deploy an HTML website from VS Code.
The CLI prints the live URL and records the project link in .htmlhost. Keep that file and deploy from the same directory to update the same site. Review any warning about remote edits before overwriting them.
Check your output before uploading
Plain HTML, CSS and browser JavaScript need no build step. A framework project may need a static export first. Upload the output directory with index.html, not source files that require a server or compiler.
For authentication errors, remote changes and asset troubleshooting, follow the full terminal deployment tutorial. For nested folders and navigation, follow multi-page static sites.