Installation#
For how to run and configure the bialet binary, see
Command Line Usage.
With the Install Script#
The easiest way to install Bialet on supported platforms (macOS ARM, Ubuntu x86_64, Ubuntu ARM) is with the install script:
curl -fsSL https://get.bialet.dev | sh
For Windows#
Download the latest bialet.exe (inside the zip) directly:
Extract and run — no installation required:
bialet.exe
Double-clicking bialet.exe in File Explorer starts it in dev mode (live
reload, in-browser error display, and the browser opens automatically). Run it
from a terminal to start without dev mode.
Releases#
Pre-built binaries for all supported platforms are available on the releases page:
Platform |
Download |
|---|---|
macOS ARM64 |
|
Linux x86_64 |
|
Linux ARM64 |
|
Windows x86_64 |
Download the archive for your platform, extract it, and place the binary
(bialet on macOS/Linux, bialet.exe on Windows) in your PATH:
# macOS / Linux
tar xzf bialet-v1.2.0-linux-x86_64.tar.gz
sudo mv bialet /usr/local/bin/
With Brew#
Use Homebrew to install Bialet on macOS or Linux:
brew install bialet/bialet/bialet
With Docker#
Run the published bialet/bialet image
directly with Docker:
docker run -t -p 7001:7001 -v "$PWD":/var/www bialet/bialet
The -t flag allocates a pseudo-TTY so the server’s logs are colored. Drop it
if you want plain, uncolored output.
The image serves the current directory, which is mounted at /var/www.
Customizing the Application Directory#
To serve a different directory, mount it at /var/www:
docker run -t -p 7001:7001 -v /path/to/app:/var/www bialet/bialet
Changing the Default Port#
The application listens on port 7001 inside the container. To expose a
different host port, use -p:
docker run -t -p 8080:7001 -v "$PWD":/var/www bialet/bialet
Building from Source#
git clone https://github.com/bialet/bialet.git
cd bialet
make
make install
For per-OS dependencies, cross-compiling (including Windows), the full list
of make targets, and the development workflow, see
CONTRIBUTING.md
on GitHub.