Bootspring
HomeGet Started

Linux Setup Guide

Complete guide to installing and configuring Bootspring on Linux distributions.

System Requirements#

RequirementMinimumRecommended
Kernel4.4+5.15+
glibc2.17+2.31+
Memory2 GB RAM8 GB RAM
Disk500 MB1 GB
Node.jsv18.0.0v20.x LTS

Supported Distributions#

DistributionVersionsStatus
Ubuntu20.04, 22.04, 24.04Full support
Debian11, 12Full support
Fedora38, 39, 40Full support
CentOS/RHEL8, 9Full support
Arch LinuxRollingFull support
openSUSELeap 15, TumbleweedFull support
Alpine3.18+Supported

Installation by Distribution#

Ubuntu / Debian#

Loading code block...

Fedora#

Loading code block...

CentOS / RHEL 8+#

Loading code block...

Arch Linux#

Loading code block...

openSUSE#

Loading code block...

Alpine Linux#

Loading code block...

Universal Method: nvm (Recommended)#

Works on all distributions:

Loading code block...

Shell Configuration#

Bash#

Add to ~/.bashrc:

Loading code block...

Apply:

Loading code block...

Zsh#

Add to ~/.zshrc:

Loading code block...

Apply:

Loading code block...

Fish#

Add to ~/.config/fish/config.fish:

Loading code block...

Apply:

Loading code block...

Authentication#

Browser Login#

Loading code block...

Opens your default browser. If no display:

Loading code block...

Environment Variable#

Loading code block...

Secure Storage with pass#

Loading code block...

Using secret-tool (GNOME)#

Loading code block...

Project Setup#

Initialize Project#

Loading code block...

Configure for Project Type#

Loading code block...

VS Code Integration#

Install VS Code#

Ubuntu/Debian:

Loading code block...

Fedora:

Loading code block...

Arch:

Loading code block...

Install Bootspring Extension#

Loading code block...

Claude Desktop Integration#

Install Claude Desktop#

Ubuntu/Debian (AppImage):

Loading code block...

Snap (if available):

Loading code block...

Flatpak (if available):

Loading code block...

Configure MCP Server#

Loading code block...

Manual Configuration#

Edit ~/.config/Claude/claude_desktop_config.json:

Loading code block...

AppImage MCP Path#

If using AppImage, you may need to specify the full path:

Loading code block...

Terminal Emulators#

GNOME Terminal#

Default on Ubuntu, Fedora GNOME. Works out of the box.

Alacritty#

Loading code block...

Kitty#

Loading code block...

Tilix#

Loading code block...

Terminator#

Loading code block...

JetBrains IDE Setup#

Install Toolbox#

Loading code block...

Configure Terminal#

Settings → Tools → Terminal:

  • Shell path: /bin/zsh or /bin/bash

Install Plugin#

  1. Settings (Ctrl+Alt+S)
  2. Plugins → Marketplace
  3. Search "Bootspring"
  4. Install

Neovim Integration#

Install Neovim#

Loading code block...

Configure for Bootspring#

Add to ~/.config/nvim/init.lua:

Loading code block...

systemd Integration#

User Service#

Create ~/.config/systemd/user/bootspring-mcp.service:

Loading code block...

Enable:

Loading code block...

npm Permission Issues#

Option 1: nvm (Recommended)#

Using nvm avoids all permission issues:

Loading code block...

Option 2: Change npm Directory#

Loading code block...

Option 3: Fix Permissions (Not Recommended)#

Loading code block...

Firewall Configuration#

UFW (Ubuntu)#

Loading code block...

firewalld (Fedora/RHEL)#

Loading code block...

Troubleshooting#

Command Not Found#

Loading code block...

Permission Denied#

Loading code block...

GLIBC Version Error#

Loading code block...

SSL Certificate Errors#

Loading code block...

Display Not Found (Browser Login)#

Loading code block...

AppArmor/SELinux Blocking#

AppArmor (Ubuntu):

Loading code block...

SELinux (Fedora/RHEL):

Loading code block...

Health Check#

Loading code block...

Expected output:

Bootspring Health Check ======================= System: ✓ Ubuntu 22.04.3 LTS ✓ Intel Core i7-12700K ✓ 32 GB RAM Runtime: ✓ Node.js v20.10.0 (x64) ✓ npm v10.2.3 ✓ Bootspring v1.2.0 Configuration: ✓ Config file: Valid ✓ Context file: Present ✓ API key: Configured Network: ✓ API: Connected ✓ Latency: 38ms Integrations: ✓ VS Code: Extension installed All 11 checks passed!

Docker Usage#

Run in Container#

Loading code block...

Docker Compose#

Loading code block...

Uninstallation#

Remove Bootspring#

Loading code block...

Clean Configuration#

Loading code block...

Remove Shell Completions#

Edit ~/.bashrc or ~/.zshrc and remove Bootspring lines.

Next Steps#