Linux Setup Guide

Complete guide to installing and configuring Bootspring on Linux distributions.

System Requirements#

Supported Distributions#

Installation by Distribution#

Ubuntu / Debian#

Fedora#

CentOS / RHEL 8+#

Arch Linux#

openSUSE#

Alpine Linux#

Universal Method: nvm (Recommended)#

Works on all distributions:

Shell Configuration#

Bash#

Add to ~/.bashrc:

Apply:

Zsh#

Add to ~/.zshrc:

Apply:

Fish#

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

Apply:

Authentication#

Browser Login#

Opens your default browser. If no display:

Environment Variable#

Secure Storage with pass#

Using secret-tool (GNOME)#

Project Setup#

Initialize Project#

Configure for Project Type#

VS Code Integration#

Install VS Code#

Ubuntu/Debian:

Fedora:

Arch:

Install Bootspring Extension#

Claude Desktop Integration#

Install Claude Desktop#

Ubuntu/Debian (AppImage):

Snap (if available):

Flatpak (if available):

Configure MCP Server#

Manual Configuration#

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

AppImage MCP Path#

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

Terminal Emulators#

GNOME Terminal#

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

Alacritty#

Kitty#

Tilix#

Terminator#

JetBrains IDE Setup#

Install Toolbox#

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#

Configure for Bootspring#

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

systemd Integration#

User Service#

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

Enable:

npm Permission Issues#

Option 1: nvm (Recommended)#

Using nvm avoids all permission issues:

Option 2: Change npm Directory#

Option 3: Fix Permissions (Not Recommended)#

Firewall Configuration#

UFW (Ubuntu)#

firewalld (Fedora/RHEL)#

Troubleshooting#

Command Not Found#

Permission Denied#

GLIBC Version Error#

SSL Certificate Errors#

Display Not Found (Browser Login)#

AppArmor/SELinux Blocking#

AppArmor (Ubuntu):

SELinux (Fedora/RHEL):

Health Check#

Expected output:

Docker Usage#

Run in Container#

Docker Compose#

Uninstallation#

Remove Bootspring#

Clean Configuration#

Remove Shell Completions#

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

Next Steps#

• Generate Context
• VS Code Setup
• Claude Desktop Setup
• Your First Workflow