Download js-cgi

Pre-built binaries are available for Linux. macOS and Windows support is coming soon.

Quick Install

The fastest way to install js-cgi on Linux:

curl -sSL https://js-cgi.com/install.sh -o install.sh
sudo bash install.sh

The interactive installer detects your architecture, installs dependencies, downloads the latest release, and optionally configures your web server.

Try Instantly

After installing, start the built-in development server — no Apache or Nginx required:

js-cgi --serve 8000

Then visit http://localhost:8000. Any .js files in the current directory are served through the engine; static files (HTML, CSS, images) are served directly.

Manual Download

Platform	Architecture	Download
Linux	x86_64	latest-linux-x86_64.tar.gz
Linux	arm64	latest-linux-arm64.tar.gz
macOS	x86_64 / arm64	Coming soon
Windows	x86_64	Coming soon

What's Included

Each archive contains:

• js-cgi — the main binary
• modules/sqlite.so — SQLite extension
• modules/session.so — session extension
• modules/file.so — file I/O extension
• modules/crypto.so — crypto extension
• modules/http.so — HTTP client extension
• modules/mysql.so — MySQL extension
• modules/smtp.so — SMTP email extension
• js-cgi.ini — default configuration
• js-cgi-module.h — header for writing custom extensions

Runtime Dependencies

Some extensions require system libraries to be installed:

Extension	Requires	Typically Pre-installed
sqlite.so	libsqlite3	Yes
crypto.so	libssl, libcrypto (OpenSSL)	Yes
http.so	libcurl	Usually
mysql.so	libmysqlclient	No
smtp.so	libssl, libcrypto (OpenSSL)	Yes
session.so	None	—
file.so	None	—

On Debian/Ubuntu, install any missing dependencies with:

sudo apt-get install -y libsqlite3-0 libssl3 libcurl4 libmysqlclient21

The install script handles this automatically.

Manual Installation

After downloading, extract and install:

tar -xzf latest-linux-x86_64.tar.gz
sudo cp js-cgi/js-cgi /usr/lib/cgi-bin/js-cgi
sudo mkdir -p /usr/lib/js-cgi/modules
sudo cp js-cgi/modules/*.so /usr/lib/js-cgi/modules/
sudo mkdir -p /etc/js-cgi
sudo cp js-cgi/js-cgi.ini /etc/js-cgi/js-cgi.ini

Build from Source

If you prefer to compile yourself, see the Getting Started guide for full build instructions.

Source Code

github.com/js-cgi/js-cgi