DocsHosting
Host a website
The Hosting add-on ($15/month, available on every plan including Free) turns a folder of files in your NextOS home into a live website. The assistant or any agent can build the site, publish it, and keep working on it afterwards without you touching a file.
How it works
- A site is a folder. Everything under
~/Sites/<name>/is the site: anindex.html, styles, images, or the output of a build tool. There is no manifest and no install step. - Ask for it. Tell the assistant "host this for me" or "build me a site for my bakery and put it online". It creates the site, writes the files, and publishes. You can also manage sites yourself in Settings › Sites.
- Publishing is versioned. Every publish creates a new immutable version. The previous version stays live until the new one is fully uploaded, and the last ten versions are kept so you can roll back from Settings › Sites in one click.
- Your site is live at two addresses:
/s/<name>/on this domain, and<name>.sites.jonkum.in. A site name is lowercase letters, digits and hyphens, 3 to 63 characters, and must be unique.
Sites are served from a global CDN. HTML pages are served through us so we can count views; images, scripts and other assets are served directly from the CDN edge.
Limits
| Per account with the add-on | |
|---|---|
| Sites | 5 |
| Size per site | 25 MB, up to 400 files |
| Bandwidth | 25 GB per month |
Publishing refuses with a clear message when a site is over its size or file cap. When the bandwidth cap is reached, the site pauses until the next month. Cancelling the add-on takes every site offline at the end of the paid period; your files stay in your home folder.
Contact forms and leads
A plain HTML form that posts to /api/sites/<name>/form is stored as a lead. Add a hidden honeypot text field named _honeypot so bots that fill it are dropped silently. Set a "forms to" address in Settings › Sites to also receive each submission by email. Field names name, email, phone and company are recognised so leads can be turned into Contacts automatically.
Page views
Turn on analytics for a site in Settings › Sites and a tiny script is added to every page to count views. No cookies are set and no visitor is identified.
Custom domains
Set a domain for a site in Settings › Sites or ask the assistant. You get a TXT record to publish at _nextos-verify.<your-domain>. Once it verifies, we finish attaching the domain on our side and the site is served there as well. Verification usually completes within a few minutes of the DNS change propagating.
Single-page apps
If your site handles its own routing, include a 200.html identical to index.html. Deep links such as /s/<name>/dashboard then serve the app shell instead of a 404.
Search engines
Sites are hidden from search engines until you turn on "indexable" for that site. That way a half-built site never gets crawled.