Algernon – small self-contained pure-Go web server

Algernon is a mall self-contained pure-Go web server with Lua, Teal, Markdown, Ollama, HTTP/2, QUIC, Redis, SQLite and PostgreSQL support.

It uses Uses Bolt (built-in), MySQL, PostgreSQL, SQLite or Redis (recommended) for the database backend, permissions2 for handling users and permissions, gopher-lua for interpreting and running Lua, optional Teal for type-safe Lua scripting, http2 for serving HTTP/2, QUIC for serving over QUIC, gomarkdown/markdown for Markdown rendering, amber for Amber templates, Pongo2 for Pongo2 templates, Sass(SCSS) and GCSS for CSS preprocessing. logrus is used for logging, goja-babel for converting from JSX to JavaScript, tollbooth for rate limiting, pie for plugins and graceful for graceful shutdowns.

This is free and open source software.

Features include:

• Supports HTTP/2, with or without HTTPS (browsers may require HTTPS when using HTTP/2).
• Also supports QUIC and regular HTTP.
• Can use Lua scripts as handlers for HTTP requests.
• The Algernon executable is compiled to native and is reasonably fast.
• Works on Linux, macOS and 64-bit Windows.
• The Lua interpreter is compiled into the executable.
• The Teal typechecker is loaded into the Lua VM.
• Live editing/preview when using the auto-refresh feature.
• The use of Lua allows for short development cycles, where code is interpreted when the page is refreshed (or when the Lua file is modified, if using auto-refresh).
• Self-contained Algernon applications can be zipped into an archive (ending with .zip or .alg) and be loaded at start.
• Built-in support for Markdown, Pongo2, Amber, Sass(SCSS), GCSS and JSX.
• Redis is used for the database backend, by default.
• Algernon will fall back to the built-in Bolt database if no Redis server is available.
• The HTML title for a rendered Markdown page can be provided by the first line specifying the title, like this: title: Title goes here. This is a subset of MultiMarkdown.
• No file converters needs to run in the background (like for SASS). Files are converted on the fly.
• If -autorefresh is enabled, the browser will automatically refresh pages when the source files are changed. Works for Markdown, Lua error pages and Amber (including Sass, GCSS and data.lua). This only works on Linux and macOS, for now. If listening for changes on too many files, the OS limit for the number of open files may be reached.
• Includes an interactive REPL.
• If only given a Markdown filename as the first argument, it will be served on port 3000, without using any database, as regular HTTP. This can be handy for viewing README.md files locally.
• Use -m to display it in a browser and only serve it once.
• Full multi-threading. All available CPUs will be used.
• Supports rate limiting, by using tollbooth.
• The help command is available at the Lua REPL, for a quick overview of the available Lua functions.
• Can load plugins written in any language. Plugins must offer the Lua.Code and Lua.Help functions and talk JSON-RPC over stderr+stdin. See pie for more information. Sample plugins for Go and Python are in the plugins directory.
• Thread-safe file caching is built-in, with several available cache modes (for only caching images, for example).
• Can read from and save to JSON documents. Supports simple JSON path expressions (like a simple version of XPath, but for JSON).
• If cache compression is enabled, files that are stored in the cache can be sent directly from the cache to the client, without decompressing.
• Files that are sent to the client are compressed with gzip, unless they are under 4096 bytes.
• When using PostgreSQL, the HSTORE key/value type is used (available in PostgreSQL version 9.1 or later).
• No external dependencies, only pure Go.
• Requires Go >= 1.21 or a version of GCC/gccgo that supports Go 1.21.
• The Lua implementation used in Algernon (gopherlua) does not support package.loadlib.

Website: github.com/xyproto/algernon
Support:
Developer: Alexander F. Rødseth
License: BSD 3-Clause “New” or “Revised” License

Algernon is written in Go and Lua. Learn Go with our recommended free books and free tutorials. Learn Lua with our recommended free books and free tutorials.

Return to Web Servers

Popular series
	The largest compilation of the best free and open source software in the universe. Each article is supplied with a legendary ratings chart helping you to make informed decisions.
	Hundreds of in-depth reviews offering our unbiased and expert opinion on software. We offer helpful and impartial information.
	The Big List of Active Linux Distros is a large compilation of actively developed Linux distributions.
	Replace proprietary software with open source alternatives: Google, Microsoft, Apple, Adobe, IBM, Autodesk, Oracle, Atlassian, Corel, Cisco, Intuit, SAS, Progress, Salesforce, and Citrix
	Awesome Free Linux Games Tools showcases a series of tools that making gaming on Linux a more pleasurable experience. This is a new series.
	Machine Learning explores practical applications of machine learning and deep learning from a Linux perspective. We've written reviews of more than 40 self-hosted apps. All are free and open source.
	New to Linux? Read our Linux for Starters series. We start right at the basics and teach you everything you need to know to get started with Linux.
	Alternatives to popular CLI tools showcases essential tools that are modern replacements for core Linux utilities.
	Essential Linux system tools focuses on small, indispensable utilities, useful for system administrators as well as regular users.
	Linux utilities to maximise your productivity. Small, indispensable tools, useful for anyone running a Linux machine.
	Surveys popular streaming services from a Linux perspective: Amazon Music Unlimited, Myuzi, Spotify, Deezer, Tidal.
	Saving Money with Linux looks at how you can reduce your energy bills running Linux.
	Home computers became commonplace in the 1980s. Emulate home computers including the Commodore 64, Amiga, Atari ST, ZX81, Amstrad CPC, and ZX Spectrum.
	Now and Then examines how promising open source software fared over the years. It can be a bumpy ride.
	Linux at Home looks at a range of home activities where Linux can play its part, making the most of our time at home, keeping active and engaged.
	Linux Candy reveals the lighter side of Linux. Have some fun and escape from the daily drudgery.
	Getting Started with Docker helps you master Docker, a set of platform as a service products that delivers software in packages called containers.
	Best Free Android Apps. We showcase free Android apps that are definitely worth downloading. There's a strict eligibility criteria for inclusion in this series.
	These best free books accelerate your learning of every programming language. Learn a new language today!
	These free tutorials offer the perfect tonic to our free programming books series.
	Linux Around The World showcases usergroups that are relevant to Linux enthusiasts. Great ways to meet up with fellow enthusiasts.
	Stars and Stripes is an occasional series looking at the impact of Linux in the USA.