Installation & Downloads

Release downloads

Notara 1.1.0 currently ships with the following downloadable installers and bundles:

Linux .deb

Debian and Ubuntu-friendly desktop package.

Linux .rpm

RPM package for Fedora, RHEL-family, and compatible distros.

Linux AppImage

Portable desktop build with no package manager required.

Windows installer

NSIS installer for Windows desktops.

Install option matrix

Option	Best for	Notes
Tauri `.deb`	Debian or Ubuntu users	Native desktop experience with automatic app-data workspace storage.
Tauri `.rpm`	Fedora or RPM-based systems	Same desktop feature set, packaged for RPM ecosystems.
Tauri `AppImage`	Portable Linux installs	Useful when you do not want system package integration.
Windows NSIS installer	Windows desktops	Native installer path for the Tauri build.
Source install	Contributors or custom builds	Run the Vite app locally and optionally launch the Tauri shell.
Docker	Self-hosted browser runtime	Serves the built SPA plus Pollinations proxy routes.

Desktop package install

Linux `.deb`

sudo dpkg -i Notara_1.1.0_amd64.deb
sudo apt-get install -f

Linux `.rpm`

sudo rpm -i Notara-1.1.0-1.x86_64.rpm

Linux `AppImage`

chmod +x Notara_1.1.0_amd64.AppImage
./Notara_1.1.0_amd64.AppImage

Windows

Run Notara_1.1.0_x64-setup.exe and follow the installer prompts.

Build from source

Prerequisites

Node.js 18+
npm or yarn
Git
Rust toolchain
On Debian or Ubuntu for desktop builds:

sudo apt-get update
sudo apt-get install -y libwebkit2gtk-4.1-dev libgtk-3-dev libayatana-appindicator3-dev librsvg2-dev patchelf

Web development

Clone the repository.

git clone https://github.com/pinkpixel-dev/notara.git
cd notara

Install dependencies.
Terminal window
```
npm install
```
Copy the example environment file.
Terminal window
```
cp .env.example .env
```
Keep auth disabled unless you explicitly want the legacy Supabase flows.
Terminal window
```
VITE_ENABLE_AUTH=false
VITE_POLLINATIONS_API_TOKEN=optional_pollinations_token
```
Start the dev server.
Terminal window
```
npm run dev
```
Open http://localhost:3489.

Desktop development

Run the Tauri shell against the local frontend:

npm run tauri:dev

Production web build

npm run build

Linux desktop bundles

npm run tauri:build:linux

Artifacts are written to:

src-tauri/target/release/bundle/deb/
src-tauri/target/release/bundle/appimage/

Docker

Build the self-hosted web runtime:

docker build -t notara:latest .

Run it:

docker run --rm -p 3489:3489 \
  -e POLLINATIONS_API_TOKEN=your_optional_pollinations_token \
  notara:latest

Then open http://localhost:3489.

The Docker image serves both the production SPA and the /api/pollinations/* endpoints used by the web app, so AI chat and image generation still work through the container runtime.

Deployment note for hosted web installs

If you deploy the web version to Cloudflare Pages, the repo already includes Pages Functions for the Pollinations routes. Mirror the optional token with:

wrangler secret put POLLINATIONS_API_TOKEN

Docs website deployment

The docs site under website/ has its own Pages config in website/wrangler.jsonc, separate from the root app config.

cd website
npx wrangler whoami
npm run deploy

For local Pages-style testing:

npm run cf:dev

Environment variables you actually need

Variable	Required	Purpose
`VITE_ENABLE_AUTH`	No	Enables the legacy Supabase auth flow only when set to `true`.
`VITE_POLLINATIONS_API_TOKEN`	No	Adds an authorization header for authenticated Pollinations requests in browser builds.
`VITE_SUPABASE_URL`	Only if auth is enabled	Supabase project URL.
`VITE_SUPABASE_ANON_KEY`	Only if auth is enabled	Supabase anon key.
`POLLINATIONS_API_TOKEN`	Optional for Docker and Cloudflare	Server-side token used by proxy routes.

Known packaging note

On some rolling-release Linux distros, AppImage packaging can fail because linuxdeploy can lag behind newer linker formats. The repository works around part of that by building with NO_STRIP=YES, and GitHub Actions on ubuntu-22.04 remain the most reliable path for AppImage output.