A static Babashka binary uploaded to a shared host can run Clojure files as a cgi-script. Essentially we can use Clojure as if it were PHP!
Create a MVP or simple web resource using Clojure on a cheap shared account. It can easily support multiple projects!
An article that covers the rationale, requirements, and setup in more detail:
https://eccentric-j.com/blog/clojure-like-its-php.html
Using multitime 1.4 within the development docker setup, the tests ran the example entrypoint
metal.clj script 20 times.
multitime -n20 -s0 ./metal.clj| Mean | Std.Dev. | Min | Median | Max | |
|---|---|---|---|---|---|
| real | 0.211 | 0.013 | 0.187 | 0.210 | 0.239 |
| user | 0.092 | 0.008 | 0.077 | 0.092 | 0.103 |
| sys | 0.052 | 0.007 | 0.045 | 0.050 | 0.071 |
- Live Example Source
- A guide to building static pods with Docker
- Depjar: A Babashka CLI script to create single jars of a clojars artifact
- A Docker environment to test babashka web scripts
The source files that are on the live demo. The libs and binaries are only place-holders. Download or build the libs, replace the place-holders, and upload those to a shared host.
If you are using this as a starting template be sure to replace any <username>
references in example/public_html/cgi.eccentric-j.com/metal.clj as well as
While some pods offer a static build in their releases page like https://github.com/babashka/babashka-sql-pods/releases. It may be necessary to build them locally then upload it to the server. This directory contains a docker file and instructions to help speed the process up.
Since tools like `clj` or `lein` will not be available on the shared host, bb can create uberjars we can upload. Depjar is a script that takes a deps.edn files, uses Babashka to install deps, then create an uberjar for each library.
./depjar/depjar.clj ./deps.ednIf you are having trouble getting it to work on a shared host you can at least use the development docker environment to try it out.
See the Readme to learn how to run the site.
In the Doom Emacs Discord, it was Taco (Elais Player) that came up with the idea and rushsteve1 that helped me understand how it would work.
Big thanks in the Clojurians’ Slack to Borkdude (Michiel Borkent) for creating Babashka and Didibus for helping me figure out the first test Clojure web script.
