Kitten

Reference sections

Kitten is a little web kit (“kitten”, get it?) optimised for people (not corporations) who make the new everyday things for themselves and other people – not because they want to become billionaires but because they want to contribute to the common good by helping nurture the Small Web while adhering to the Small Technology Principles.

Kitten features intuitive file system-based routing, HTML and accessibility validation, a built-in object database, WebSockets, zero-code authentication, public-key cryptography, Markdown support, syntax highlighting via highlight.js, semantic styles via Water CSS, and more.

For production servers, only Linux with systemd is supported.

To install Kitten, either:

You can update Kitten in two ways:

Kitten’s API version 0 releases (23 April, 9 October, and 21 October 2026) do not automatically update themselves to API version 1. On the 23 April and 9 October releases, the kitten update command moves Kitten to the 21 October release. On the 21 October release, the kitten update command reports that Kitten is up to date. To upgrade to API 1, please run the installer again (curl -sL https://kittens.small-web.org/install | bash).

For more details, please see Upgrading from API version 0 to API version 1.

You run kitten from the command-line (using a terminal app). Switch to a folder that has the content you want Kitten to serve and enter the following command:

kitten

You should see Kitten launch and tell you that it’s serving your site or app at https://localhost.

You’re not limited to accessing your local machine via https://localhost, either. You can also use any local IP address that it’s accessible from (see Accessing your local machine from other devices on your local area network for more information). You can also use the IP aliases 127.0.0.2 - 127.0.0.4 and localhost aliases (subdomains) place1.localhost - place4.localhost without certificate errors. The latter, especially, are useful when testing the peer-to-peer features of Small Web apps.

Small Web places made with Kitten are meant to be owned and used by one person. Until an identity and secret has been generated for this person, Kitten will display a link to the special page that generates them. (Your secret on a Small Web place never hits the server.) You can also generate this secret from Kitten’s REPL using the .id create command.)

Note that the first time Kitten is run, it will create a TLS certificate authority and add it to your system trust stores as well as to Firefox and Chrome so you can run your development environment from https://localhost to match the deployment environment as closely as possible. Your operating system will ask your permission before allowing this.

By default, Kitten will be as quiet as possible and only surface warnings and errors. If you want more extensive logging, start it with the LOG environment variable set to the log sections you want to see:

LOG=<sections> kitten [path to serve]

Similarly, if you want to see performance statistics, set the PROFILE environment variable to true.

Like this? Fund us!

Small Technology Foundation is a tiny, independent not-for-profit.

We exist in part thanks to patronage by people like you. If you share our vision and want to support our work, please become a patron or donate to us today and help us continue to exist.