Install Gruxi with prebuilt binaries

Prebuilt binaries provide the best performance and are ideal for users who want a simple, standalone installation without the overhead of a container. They are suitable for both development and production on any platform.

When using the prebuilt binaries, Gruxi only writes data relative to the directory it is run from, so you can easily manage persistence by running it from a specific location. Logs are kept in the logs directory, and the database is stored in the db directory. You can also place your web content in the www-default directory or configure additional sites via the admin portal.

TIP

If you're running on Linux on a Debian-based system, consider using the package installation method for easier installation and service management. It also uses the same prebuilt binaries under the hood, but with added convenience, integration with systemd, and security hardening.

1. Download the release

You can download the latest release from GitHub Releases. Choose the appropriate archive for your platform (e.g., .tar.gz for Linux/macOS or .zip for Windows). Also verify that the release architecture matches your system (e.g., amd64 for x86-64 systems, arm64 for Apple Silicon or ARM-based Linux).

2. Extract and run

First, you need to extract the downloaded archive. On Windows, you can use built-in extraction tools or third-party software like 7-Zip. On Linux and macOS, you can use the tar command:

tar -xzf gruxi-<version>-linux-amd64.tar.gz

To run on Windows, open a Command Prompt (you may need to run it as Administrator) in the extracted directory and run:

gruxi.exe

For PowerShell, use:

.\gruxi.exe

To run on Linux or macOS, open a terminal in the extracted directory and run:

./gruxi

3. Verify installation

Open http://localhost to see the default Gruxi page.

4. Configure installation

Open https://localhost:8000 and log in with the user admin and the password printed to the server output on first run. Save it, as it will not be shown again.

Next step

You now have a working Gruxi instance running on your system or server.

Next, learn how to configure Gruxi.