Hub Installation

Install the SeaClip hub server with a single command

Prerequisites
  • Linux, macOS, or WSL2
  • Node.js 20+ (will be installed if missing)
  • 4GB RAM minimum (8GB recommended)
  • 10GB disk space

One-Line Install

Option A: Interactive Install (Recommended)

This script guides you through edition selection and configuration:

bash
curl -sSL https://raw.githubusercontent.com/t4tarzan/seaclip/main/scripts/install.sh | bash

Option B: Direct Edition Install

Skip the prompts by specifying your edition:

bash — v1-simple (base features)
curl -sSL https://raw.githubusercontent.com/t4tarzan/seaclip/main/scripts/install.sh | bash -s -- simple
bash — v2-enhanced (full features)
curl -sSL https://raw.githubusercontent.com/t4tarzan/seaclip/main/scripts/install.sh | bash -s -- enhanced

Option C: Clone and Install

If you prefer to inspect the script first:

bash
git clone https://github.com/t4tarzan/seaclip.git
cd seaclip
./scripts/install.sh

What the Installer Does

  1. Checks prerequisites

    Verifies Node.js, pnpm, and system requirements

  2. Clones the repository

    Downloads SeaClip to /opt/seaclip (or your chosen directory)

  3. Installs dependencies

    Runs pnpm install to fetch all packages

  4. Configures the edition

    Sets up .env with your chosen edition and features

  5. Initializes the database

    Creates SQLite database (or connects to PostgreSQL)

  6. Starts the server

    Launches SeaClip on port 51842

Post-Installation

Access the Dashboard

Open your browser to:

url
http://localhost:51842

Run the Onboarding Wizard

Configure your hub interactively:

bash
cd /opt/seaclip
pnpm cli onboard

Check System Health

Verify everything is working:

bash
pnpm cli doctor
$ pnpm cli doctor
✓ Node.js version: 20.11.0
✓ pnpm version: 8.15.0
✓ Database: connected (SQLite)
✓ Server: running on port 51842
✓ WebSocket: active
✓ Ollama: connected (http://localhost:11434)

All checks passed! SeaClip is healthy.

Service Management

Start/Stop Commands

Action Command
Start (development) pnpm dev
Start (production) pnpm start
Stop Ctrl+C or pkill -f seaclip
Restart pnpm restart

Run as a System Service (systemd)

For production deployments, install SeaClip as a systemd service:

bash
sudo cp /opt/seaclip/scripts/seaclip.service /etc/systemd/system/
sudo systemctl daemon-reload
sudo systemctl enable seaclip
sudo systemctl start seaclip

Check status:

bash
sudo systemctl status seaclip

Environment Variables

Key environment variables (set in .env):

Variable Description Default
PORT HTTP server port 51842
SEACLIP_EDITION Edition: simple, enhanced, custom simple
DATABASE_URL PostgreSQL connection string SQLite
OLLAMA_BASE_URL Ollama API endpoint http://localhost:11434
JWT_SECRET Secret for JWT tokens auto-generated
SEACLIP_DEPLOYMENT_MODE local_trusted or authenticated local_trusted

Next Steps