Start here
Static sites
Publish HTML, CSS, JavaScript and images. Nothing is built: the files are served as they are, over HTTPS.
Upload
- One page: upload an
.htmlfile; it becomes the home page. - A whole site: upload a
.zipwithindex.htmlat the top, or inside a single folder (as most zip tools make it). Up to 150 MB, 10,000 files and 500 MB unpacked. Mac and Windows extras such as__MACOSXand.DS_Storeare left out.
From Git
Give the repository's HTTPS address, the branch, and the folder to publish (for example
public or docs/site; empty means the whole repository). The folder must contain
index.html. Nothing is built (no npm): commit the finished files, or the output of your build. Private
repositories and deploy on push work as for Java apps: see Git and deploy on push.
How pages are served
/aboutservesabout.html, and/blog/servesblog/index.html.- A
404.htmlat the top is shown for pages that don't exist. - Files and folders starting with a dot are never served (except
.well-known). - There's no fallback to
index.htmlfor unknown paths, so a single-page app's routes need real files or links with#.
A site gets 128 MB of memory, which is plenty for nginx, on any plan.
Redirects and headers
Under the site's Settings, the box Maintenance mode, redirects and headers holds rules for the site's web server. Owners and admins change them; saving deploys the site again with them, which takes about a minute.
Redirects go one a line: the old address, then where it goes.
/old-page /new-page
/shop https://shop.example.com/ 302
- The old address is a path on the site. It's matched exactly, without what follows a
?, and/old-pagealso covers/old-page/. - Where it goes is a path on the site, or a full address such as
https://example.com/page. - It's a redirect for good (301) unless you add
302at the end;307and308work too. - Up to 100 redirects. Lines starting with
#are notes.
Response headers go one a line as Name: value, and are sent with every answer of the site:
X-Frame-Options: DENY
Content-Security-Policy: default-src 'self'
Up to 20. Headers the web server sets itself, such as Content-Type, can't be changed, and
X-Content-Type-Options: nosniff is always sent. A staging copy of a site takes its redirects and
headers along.
Maintenance mode
Turn on Maintenance mode in the same box and every visitor gets a "back soon" page instead of the site, with
status 503, so search engines come back later instead of dropping your pages. To show your own page, put a
maintenance.html at the top of the site, with its styles and images inside that one file: nothing else
is served meanwhile. Turning it on or off deploys the site again.
Uptime checks pause while it's on.
Your own domain
Add your domain under the site's Domains tab, and make it primary so every other address, including
the oceanlaunch.app one, redirects to it. See Custom domains.