# Advanced Installation

To install starship, you need to do two things:

  1. Get the starship binary onto your computer
  2. Tell your shell to use the starship binary as its prompt by modifying its init scripts

For most users, the instructions on the main page will work great. However, for some more specialized platforms, different instructions are needed.

There are so many platforms out there that they didn't fit into the main README.md file, so here are some installation instructions for other platforms from the community. Is yours not here? Please do add it here if you figure it out!

# Chocolatey (opens new window)

# Prerequisites

Head over to the Chocolatey installation page (opens new window) and follow the instructions to install Chocolatey.

# Installation

choco install starship

# termux (opens new window)

# Prerequisites

pkg install getconf

# Installation

curl -sS https://starship.rs/install.sh | sh -s -- --bin-dir /data/data/com.termux/files/usr/bin

# Funtoo Linux (opens new window)

# Installation

On Funtoo Linux, starship can be installed from core-kit (opens new window) via Portage:

emerge app-shells/starship

# Nix (opens new window)

# Getting the Binary

# Imperatively

nix-env -iA nixos.starship

# Declarative, single user, via home-manager (opens new window)

Enable the programs.starship module in your home.nix file, and add your settings

{
  programs.starship = {
    enable = true;
    # Configuration written to ~/.config/starship.toml
    settings = {
      # add_newline = false;

      # character = {
      #   success_symbol = "[➜](bold green)";
      #   error_symbol = "[➜](bold red)";
      # };

      # package.disabled = true;
    };
  };
}

then run

home-manager switch

# Declarative, system-wide, with NixOS

Add pkgs.starship to environment.systemPackages in your configuration.nix, then run

sudo nixos-rebuild switch