veos vault

Install veos on your machine

One line on Linux, one line on Windows, and how to check what you are running before you run it.

Article4 min

veos is a single binary with no dependencies: nothing to install alongside it, no Node, no Python. It reads your organisation’s vault and hands the variables to your commands, without ever writing a .env file to disk.

Linux

Terminal

curl -fsSL https://veos.eosdev.fr/install.sh | sh

The script picks /usr/local/bin when it can write there and your ~/.local/bin otherwise. It never asks for sudo and never edits your shell configuration: if the chosen directory is not on your PATH, it prints the exact line to add and leaves the decision to you.

The three-step variant

curl -fsSL https://veos.eosdev.fr/install.sh -o install.sh
sha256sum install.sh
sh install.sh

Windows

PowerShell

irm https://veos.eosdev.fr/install.ps1 | iex

PowerShell 5.1, the one that ships with Windows, is enough. It installs into your user folder and needs no administrator rights; the PATH it changes is yours, not the machine’s. Open a new terminal for the command to be found.

The three commands that follow

  1. 1

    veos login

    Signs this machine in. Once is enough.

  2. 2

    veos setup

    Links the current folder to a project and an environment of the vault, so the commands that follow know what to read.

  3. 3

    veos run -- npm run dev

    Runs your command with the variables in its environment. They exist for the lifetime of that process, and never in a file.

Frequently asked

Do I need administrator rights?

No. On Linux the installer falls back to your ~/.local/bin when it cannot write to /usr/local/bin, and it never elevates itself. On Windows everything happens inside your user folder.

How do I update veos?

Run the same install line again: it replaces the binary in place, even while a veos command is running.

How do I uninstall it?

Delete the file: /usr/local/bin/veos or ~/.local/bin/veos on Linux, %LOCALAPPDATA%\Programs\veos on Windows. No service, no scheduled task, nothing else is written anywhere.

Can I install a specific version?

Yes, with VEOS_VERSION. In a piped line the variable goes on sh, not on curl: curl -fsSL https://veos.eosdev.fr/install.sh | VEOS_VERSION=0.1.0 sh. The installer then asks the API for the digest of that version, and refuses to install if the downloaded bytes do not match.

Is macOS supported?

Not yet: the installer stops and says so, rather than downloading a binary that would not start.