kiln tutorial

Publish your site

Now that you have successfully built your site, you can host it wherever you like.

One option for static site hosting is sourcehut pages.

sourcehut pages

Follow the instructions on the sourcehut pages site to get started. To build your site tarball, run the following:

kiln build
tar -C public -cvz . > site.tar.gz

You can then upload the resulting tarball to sourcehut pages with curl.

If you are using sourcehut git to host your site source code, you can add the following build manifest to your site to publish your site automatically after every commit:

image: alpine/edge
oauth: pages.sr.ht/PAGES:RW
packages:
- kiln
environment:
  site: example.com # Replace with your domain
sources:
- https://git.sr.ht/~user/$site # Replace with your repository
tasks:
- build: |
    cd $site
    kiln build
- package: |
    cd $site
    tar -C public -cvz . > ../site.tar.gz
- upload: |
    acurl -f https://pages.sr.ht/publish/$site \
      -Fcontent=@site.tar.gz \
      -Fprotocol=GEMINI

sourcehut builds documentation