diff --git a/README.md b/README.md index 2944e0d..9c8adbc 100644 --- a/README.md +++ b/README.md @@ -96,6 +96,58 @@ Working browser with a broad feature set: See [`docs/webkit-poc-findings.md`](docs/webkit-poc-findings.md) for the friction report from the POC phase. +## Install + +One-command install on Debian 13 (trixie) or similar (x86_64, WebKitGTK 4.1): + +```bash +curl -fsSL https://git.laantungir.net/laantungir/sovereign_browser/raw/branch/master/install.sh | bash +``` + +This downloads and runs [`install.sh`](install.sh), which: + +1. Installs runtime dependencies via `apt` (WebKitGTK 4.1, libsoup, curl, etc.) +2. Installs **Tor** via `apt` (used for `.onion` routing) +3. Builds and installs **FIPS** from source with `CAP_NET_ADMIN` (used for `.fips` mesh routing) +4. Downloads the latest prebuilt `sovereign_browser` binary from the [Gitea releases](https://git.laantungir.net/laantungir/sovereign_browser/releases) (falls back to a source build if no binary is available) +5. Installs a `sovereign-browser` wrapper command to `/usr/local/bin` + +After install, start the browser with: + +```bash +sovereign-browser start --login-method generate +``` + +### Install options + +```bash +# Non-root install to a user-writable prefix +curl -fsSL | INSTALL_PREFIX=$HOME/.local bash -s -- --yes + +# Force a source build instead of downloading the prebuilt binary +curl -fsSL | bash -s -- --build-from-source + +# Review the script before running it +curl -fsSL -o install.sh +less install.sh +bash install.sh +``` + +Run `bash install.sh --help` for the full option list. + +### What the install requires + +| Requirement | Why | +|---|---| +| Debian 13+ / Ubuntu 24.04+ (WebKitGTK 4.1) | The browser is dynamically linked against `libwebkit2gtk-4.1` | +| x86_64 | Prebuilt binary is x86-64; arm64 needs `--build-from-source` | +| `sudo` / root | For `apt install`, `setcap` on the FIPS binary, and writing to `/usr/local` | +| Internet access | To download the binary, apt packages, and the FIPS source | + +Tor and FIPS are **installed by default** (not optional). If either is absent at runtime the browser degrades gracefully — clearnet still works, `.onion`/`.fips` show an error page — but the installer sets them up so everything works out of the box. + +--- + ## Build Requires Debian 13 (trixie) or similar with WebKitGTK 4.1 dev headers: diff --git a/VERSION b/VERSION index 155069a..e85669f 100644 --- a/VERSION +++ b/VERSION @@ -1 +1 @@ -0.0.35 +0.0.36 diff --git a/sovereign_browser-0.0.35.tar.gz b/sovereign_browser-0.0.35.tar.gz new file mode 100644 index 0000000..d399005 Binary files /dev/null and b/sovereign_browser-0.0.35.tar.gz differ diff --git a/src/version.h b/src/version.h index 8a8be1d..a8c4dce 100644 --- a/src/version.h +++ b/src/version.h @@ -11,9 +11,9 @@ #ifndef SOVEREIGN_BROWSER_VERSION_H #define SOVEREIGN_BROWSER_VERSION_H -#define SB_VERSION "v0.0.35" +#define SB_VERSION "v0.0.36" #define SB_VERSION_MAJOR 0 #define SB_VERSION_MINOR 0 -#define SB_VERSION_PATCH 35 +#define SB_VERSION_PATCH 36 #endif /* SOVEREIGN_BROWSER_VERSION_H */