Installation

There are several ways to run Stina. Choose the one that best fits your setup.

Desktop App (Recommended)

The easiest way to get started is to download the desktop app from GitHub Releases.

1. Go to GitHub Releases
2. Download the installer for your platform:
   • macOS — .dmg file (Apple Silicon and Intel)
   • Windows — .exe installer
   • Linux — .AppImage or .deb
3. Run the installer and launch Stina
4. On first launch, you’ll be guided through connecting an AI provider

Tip

For the best offline experience, install Ollama alongside Stina, then enable the Ollama extension inside the app.

Docker

Run Stina as a self-hosted web app using Docker Compose.

Quick Start

curl -O https://raw.githubusercontent.com/einord/stina/main/docker-compose.yml
docker compose up -d

Open localhost:3002 in your browser.

Configuration

The Docker setup runs two containers:

• stina-api on port 3001 — Backend API server
• stina-web on port 3002 — Web frontend

You can customize the deployment with environment variables:

Variable	Default	Description
STINA_VERSION	latest	Docker image tag
STINA_DATA_PATH	./data	Path to persistent data directory

Example with custom data path:

STINA_DATA_PATH=/opt/stina/data docker compose up -d

Docker Compose File

services:
  api:
    container_name: stina-api
    image: ghcr.io/einord/stina-api:${STINA_VERSION:-latest}
    restart: unless-stopped
    ports:
      - '3001:3001'
    environment:
      NODE_ENV: production
      DB_PATH: /data/data.db
      EXTENSIONS_PATH: /data/extensions
    volumes:
      - ${STINA_DATA_PATH:-./data}:/data

  web:
    container_name: stina-web
    image: ghcr.io/einord/stina-web:${STINA_VERSION:-latest}
    restart: unless-stopped
    ports:
      - '3002:3002'
    depends_on:
      - api

From Source

For developers who want to build and run Stina from source.

Prerequisites

• Node.js 20 or later
• pnpm 9 or later
• Git

Steps

git clone https://github.com/einord/stina.git
cd stina
pnpm install
pnpm build:packages

Then choose how to run it:

# Web (API + frontend)
pnpm dev:web

# Desktop (Electron)
pnpm dev:electron

# CLI
pnpm dev:tui

Ports

Service	Port
API	3001
Web	3002
Electron renderer	3003