Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/erickm13/Salchipapa.Dots/llms.txt

Use this file to discover all available pages before exploring further.

The manual installation path is for users who want full control over each step, who are installing only a subset of the tools, or whose system encountered an error during the automated installer. Every command below is taken directly from the Salchipapa.Dots source. Follow the steps in order and you will end up with the same result as the automated installer — without any black-box magic.
Replace salchipapatest with your actual Linux username wherever it appears in the commands below.
1

Update Your System

Refresh your package lists, upgrade any outdated packages, and install the build essentials that Homebrew and other tools depend on:
sudo apt update
sudo apt upgrade
sudo apt install build-essential curl git ca-certificates
2

Install Homebrew and Set Up Your PATH

Run the official Homebrew installer and add Homebrew to your shell environment so subsequent commands can find brew:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
echo >> /home/salchipapatest/.bashrc
echo 'eval "$(/home/linuxbrew/.linuxbrew/bin/brew shellenv)"' >> /home/salchipapatest/.bashrc
eval "$(/home/linuxbrew/.linuxbrew/bin/brew shellenv)"
After this step, brew will be available in your current shell session and in all future sessions for this user.
3

Install Core Packages via Homebrew

Install all core tools in a single Homebrew command:
brew install gcc nvim zsh zsh-autocomplete zsh-syntax-highlighting zsh-autosuggestions carapace fzf zoxide atuin zellij fd eza bat nvm
This installs the compiler toolchain, Neovim, Zsh and its plugins, carapace completions, fzf fuzzy finder, zoxide smart cd, atuin shell history, the Zellij multiplexer, and modern file utilities.
4

Install Node.js and CLI Tools

Use nvm to install the latest Node.js release, then install the npm CLI tools globally:
nvm install node
npm install -g @google/gemini-cli
npm install -g @angular/cli
npm install -g @anthropic-ai/claude-code
If you only need a subset of these CLIs, omit the ones you don’t want.
5

Set Zsh as Your Default Shell

Register the Homebrew-managed Zsh with the system’s list of valid shells, then change your login shell:
echo "/home/linuxbrew/.linuxbrew/bin/zsh" | sudo tee -a /etc/shells
chsh -s /home/linuxbrew/.linuxbrew/bin/zsh $USER
You will need to log out and back in (or open a new terminal session) for the shell change to take effect.
6

Link Your Zsh Config

Remove any existing .zshrc and replace it with a symlink to the Salchipapa.Dots Zsh configuration:
rm -f ~/.zshrc
ln -s ~/Salchipapa.Dots/SalchipapaZsh/.zshrc ~/.zshrc
source ~/.zshrc
7

Install Oh My Zsh

Install Oh My Zsh using the official installer script:
sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"
When Oh My Zsh prompts you to overwrite your existing .zshrc, choose No. Overwriting it would replace the symlink you created in the previous step with Oh My Zsh’s default config, discarding the Salchipapa.Dots configuration.
After the installer finishes, reload your config:
source ~/.zshrc
8

Link Zellij and Neovim Configurations

Create the ~/.config directory if it does not exist, then symlink both the Zellij and Neovim config directories:
mkdir -p ~/.config
ln -s ~/Salchipapa.Dots/SalchipapaZellij/zellij/ ~/.config/zellij
ln -s ~/Salchipapa.Dots/SalchipapaNvim/nvim/ ~/.config/nvim
9

Sync Neovim Plugins

Run a headless Neovim session to download and install all LazyVim plugins without opening the editor interactively:
nvim --headless "+Lazy! sync" +qa
This may take a minute or two on the first run as it fetches all plugins from their remote repositories.
10

Install IosevkaTerm NF

Salchipapa.Dots uses IosevkaTerm Nerd Font for icon rendering across Neovim, Starship, and Fastfetch. Download and install it from nerdfonts.com.After installing the font, set IosevkaTerm NF (or IosevkaTerm Nerd Font Mono) as the font in your terminal emulator settings.

​
Optional Configurations

If you prefer Fish over Zsh, install it via Homebrew, register it as a valid shell, set it as your default, and symlink the Fish config directory:
brew install fish
echo "/home/linuxbrew/.linuxbrew/bin/fish" | sudo tee -a /etc/shells
chsh -s /home/linuxbrew/.linuxbrew/bin/fish $USER
ln -s ~/Salchipapa.Dots/SalchipapaFish/fish ~/.config/fish
Fish uses Fisher for plugin management. The SalchipapaFish/fish/fish_plugins file tracks the installed plugins (jorgebucaran/nvm.fish, patrickf1/fzf.fish, oh-my-fish/plugin-pj). On first launch, Fisher will install them automatically if Fisher itself is bootstrapped.

​
Optional: Alacritty Config

To apply the Solarized Osaka–themed Alacritty configuration, symlink the SalchipapaAlacritty directory into ~/.config: 
ln -s ~/Salchipapa.Dots/SalchipapaAlacritty ~/.config/alacritty

​
Optional: WezTerm Config

To apply the WezTerm configuration, symlink the .wezterm.lua file into your home directory: 
ln -s ~/Salchipapa.Dots/SalchipapaWezterm/.wezterm.lua ~/.wezterm.lua
WezTerm reads ~/.wezterm.lua automatically on startup — no additional configuration is needed.

Build docs developers (and LLMs) love

Get started for freeTalk to us