2022-03-11 20:48:44 +00:00
|
|
|
# Advanced Installation
|
2021-01-05 23:05:03 +00:00
|
|
|
|
|
|
|
|
To install starship, you need to do two things:
|
|
|
|
|
|
|
|
|
|
1. Get the **starship** binary onto your computer
|
|
|
|
|
1. Tell your shell to use the starship binary as its prompt by modifying its init scripts
|
|
|
|
|
|
2024-03-03 16:55:30 +00:00
|
|
|
For most users, the instructions on [the main page](../guide/#🚀-installation) will work great. However,
|
2021-01-05 23:05:03 +00:00
|
|
|
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!
|
2021-03-07 21:40:03 +00:00
|
|
|
|
|
|
|
|
## [Chocolatey](https://chocolatey.org)
|
|
|
|
|
|
|
|
|
|
### Prerequisites
|
|
|
|
|
|
2022-01-20 08:32:09 +00:00
|
|
|
Head over to the [Chocolatey installation page](https://chocolatey.org/install) and follow the instructions to install Chocolatey.
|
2021-03-07 21:40:03 +00:00
|
|
|
|
|
|
|
|
### Installation
|
|
|
|
|
|
|
|
|
|
```powershell
|
|
|
|
|
choco install starship
|
|
|
|
|
```
|
|
|
|
|
|
2021-02-21 09:36:03 +00:00
|
|
|
## [termux](https://termux.com)
|
2021-03-07 21:40:03 +00:00
|
|
|
|
2021-02-21 09:36:03 +00:00
|
|
|
### Prerequisites
|
2021-03-07 21:40:03 +00:00
|
|
|
|
2021-02-21 09:36:03 +00:00
|
|
|
```sh
|
|
|
|
|
pkg install getconf
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
### Installation
|
2021-03-07 21:40:03 +00:00
|
|
|
|
2021-02-21 09:36:03 +00:00
|
|
|
```sh
|
2022-03-08 20:47:54 +00:00
|
|
|
curl -sS https://starship.rs/install.sh | sh -s -- --bin-dir /data/data/com.termux/files/usr/bin
|
2021-02-21 09:36:03 +00:00
|
|
|
```
|
2021-01-05 23:05:03 +00:00
|
|
|
|
2021-10-06 18:24:49 +00:00
|
|
|
## [Funtoo Linux](https://www.funtoo.org/Welcome)
|
|
|
|
|
|
|
|
|
|
### Installation
|
|
|
|
|
|
|
|
|
|
On Funtoo Linux, starship can be installed from [core-kit](https://github.com/funtoo/core-kit/tree/1.4-release/app-shells/starship) via Portage:
|
|
|
|
|
|
|
|
|
|
```sh
|
|
|
|
|
emerge app-shells/starship
|
|
|
|
|
```
|
|
|
|
|
|
2024-05-12 07:58:12 +00:00
|
|
|
## [Nix](https://wiki.nixos.org/wiki/Nix)
|
2021-01-05 23:05:03 +00:00
|
|
|
|
|
|
|
|
### Getting the Binary
|
|
|
|
|
|
|
|
|
|
#### Imperatively
|
|
|
|
|
|
|
|
|
|
```sh
|
|
|
|
|
nix-env -iA nixos.starship
|
|
|
|
|
```
|
|
|
|
|
|
2021-03-24 16:02:14 +00:00
|
|
|
#### Declarative, single user, via [home-manager](https://github.com/nix-community/home-manager)
|
2021-01-05 23:05:03 +00:00
|
|
|
|
2021-02-23 17:49:27 +00:00
|
|
|
Enable the `programs.starship` module in your `home.nix` file, and add your settings
|
|
|
|
|
|
|
|
|
|
```nix
|
|
|
|
|
{
|
|
|
|
|
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
|
2021-01-05 23:05:03 +00:00
|
|
|
|
|
|
|
|
```sh
|
|
|
|
|
home-manager switch
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
#### Declarative, system-wide, with NixOS
|
|
|
|
|
|
2021-02-23 17:49:27 +00:00
|
|
|
Add `pkgs.starship` to `environment.systemPackages` in your `configuration.nix`,
|
2021-01-05 23:05:03 +00:00
|
|
|
then run
|
|
|
|
|
|
|
|
|
|
```sh
|
|
|
|
|
sudo nixos-rebuild switch
|
|
|
|
|
```
|
