Download

Install SeqDesk

One guided command. The installer checks every prerequisite first and stops without changing anything if something is missing. The app listens on port 8000, and you create the administrator account during setup.

Step-by-step guideRequirementsHaving trouble?
Linux · macOS
curl -fsSLo /tmp/seqdesk-install.sh https://seqdesk.org/install.sh &&
bash /tmp/seqdesk-install.sh --interactive --dir "$HOME/seqdesk"

When to use: Almost everyone. Downloading first preserves the guided prompts, avoids a global npm install, and lets you inspect the script before running it.

Needs Node.js 22.13.0+ (22.x line) or 24.x, plus npm. No database preparation: SeqDesk reuses a PostgreSQL you already own, or creates its own. Add --with-pipelines for Conda and Nextflow.

Detailed guide →

Before you start

What you need

Install first

On the host

  • Node.js >=22.13.0 <23 or >=24 <25, plus npm
  • Linux, or macOS on x64 or arm64
  • A new writable directory with at least 2 GB free

Handled for you

SeqDesk sets up

  • PostgreSQL. A healthy local server is reused untouched. If you have none, SeqDesk installs its own — no open port, no system service, no sudo.
  • Migrations and your first administrator account
  • Optional pipeline runtime and process management

Running a facility instance? Storage, backups, TLS, and compute capacity remain yours to plan. Full prerequisites and the exact check matrix →

After installing

Check it before adding real data

seqdesk doctor --dir "$HOME/seqdesk"

Sign in with the administrator account you created, then run the health check. Configure storage, pipeline runtime, and backup restoration in Admin before storing facility data.

What the health check verifies →

Support

Having trouble?

Every installer failure names the check that failed and links to its fix. If you need more than that, start here.

Common problems

Node.js rejected, npm permissions, proxies and firewalls, database connection failures, and unwritable targets.

Troubleshooting index →

Platform guides

Full walkthroughs with the fixes specific to each operating system, including PostgreSQL setup.

macOS →Linux →

Tested platforms

A platform counts as demonstrated only when its installation check is green. Installation evidence is not a performance or security audit.

CI coverage matrix →