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
-
Checks prerequisites
Verifies Node.js, pnpm, and system requirements
-
Clones the repository
Downloads SeaClip to
/opt/seaclip(or your chosen directory) -
Installs dependencies
Runs
pnpm installto fetch all packages -
Configures the edition
Sets up
.envwith your chosen edition and features -
Initializes the database
Creates SQLite database (or connects to PostgreSQL)
-
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.
✓ 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 |