Fleek has only one dependency: Nix.
We highly recommend the Determinate Systems Installer, but any
nix installer is good.
curl --proto '=https' --tlsv1.2 -sSf -L https://install.determinate.systems/nix | sh -s -- install
After Nix is installed you need to enable flakes and the nix command. This is already done if you use the Determinate Systems Installer. Otherwise, it can be as simple as this:
mkdir -p ~/.config/nix
echo "experimental-features = nix-command flakes" >> ~/.config/nix/nix.conf
Create Your Initial Fleek Configuration
We're going to use the power of Nix flakes and the convenience of FlakeHub to bootstrap the latest version of Fleek without installing it locally.
nix run "https://getfleek.dev/latest.tar.gz" -- init
This will create your configuration file and symlink it to
$HOME/.fleek.yml. Open it with your favorite editor and take a look.
Make any changes to the
~/.fleek.yml file you want... we recommend Bling Level
high for the best experience.
Now let's apply your configuration:
nix run "https://getfleek.dev/latest.tar.gz" -- apply
It will take a bit to download and install everything, but when it's done you should see something like this:
... more text above this ...
[✓] Operation completed successfully
After running your first
apply, you can use the
fleek command to manage your fleek configuration.
Possible Errors: Existing Files
You might see an error telling you that the installation failed because a file already exists. Fleek will create new shell configuration files for you, but it won't overwrite existing ones. You'll need to move or delete the existing files before Fleek can install the new ones. Try
mv ~/.bashrc ~/.bashrc.bak (substituting the appropriate file names) and then run the apply command again.
What happened here? We just installed Nix Home Manager, configured it with your preferences, and applied it to your system.
You may need to close and re-open your terminal or even log out to see the changes.
Deprecated Installation Options
These options are deprecated and will be removed in the next release. Fleek is now self-managing and should be installed with the bootstrap instructions above.
Unreachable Code Here
If you use any of these deprecated installation options, the version of Fleek you install will be listed after the version of Fleek that gets installed when you apply your configuration. This is by design to ensure that Fleek can update itself.
Nix Profile (Deprecated)
You can install Fleek to your default nix profile with this command:
nix profile install github:ublue-os/fleek
This will add Fleek to your default nix profile (don't worry if you don't know what this means yet), which will be available in your $PATH.
GitHub Releases (Deprecated)
You can also download fleek from the GitHub releases link and move it somewhere in your $PATH.
The gzip'd tarball contains a binary,
man directory, and a
completions directory. You can skip the
completions directories if you don't need them.
Be sure to move
fleek to somewhere in your $PATH. If you're not sure where that is, try
echo $PATH to see what directories are in your path.
If you have Homebrew installed, you can use the Fleek tap:
brew tap ublue-os/homebrew-tap
brew install fleek