dsv-n8n 🚀

The local-first workspace manager for n8n.

Built by DataScience Ville, dsv-n8n is a premium CLI tool that eliminates the headache of managing local n8n environments. It automatically handles Docker Compose generation, prevents port collisions, and securely manages your encryption keys.

⚡ Quick Start

You don't even need to install it. You can run it instantly using npx:

npx dsv-n8n init my-workspace

Or, install it globally for everyday use:

npm install -g dsv-n8n

🛠️ The Arsenal (Commands)

• dsv-n8n init <name> — Scaffolds a new, isolated n8n workspace/profile with a localized SQLite database and auto-assigned ports.
• dsv-n8n start [name] — Boots your workspace in the background and opens your browser.
• dsv-n8n stop [name] — Pauses your workspace to free up system RAM.
• dsv-n8n stop all — The panic button. Safely spins down every active n8n container on your system.
• dsv-n8n list — View a Rolodex of all your active workspaces and their assigned ports.
• dsv-n8n info <name> — Retrieves your secure N8N_ENCRYPTION_KEY and local URLs.
• dsv-n8n delete <name> — Safely destroys a workspace and its data.

🧠 Works Smartly With Pre-existing Profiles

Have an old n8n setup you want to track? Just navigate to your old folder and run dsv-n8n start. The CLI will automatically detect untracked docker-compose.yml files, ask for permission, and adopt them into your global fleet.

📋 Requirements

• Node.js (v16+)
• Docker Desktop (Must be running in the background)