Logo

Installing EnvVault on Linux

EnvVault can be installed on Linux using package managers or through manual installation. Choose the method that best suits your distribution and preferences.

Installing on Debian/Ubuntu

Add the EnvVault repository and install:

# Add the EnvVault GPG key
curl -s https://packages.envvault.dev/gpg/ | sudo apt-key add -

# Add the repository
echo "deb [trusted=yes] https://packages.envvault.dev/apt stable main" | sudo tee /etc/apt/sources.list.d/envvault.list

# Update package list and install
sudo apt update
sudo apt install envvault

System Requirements

Supported Distributions:

  • Ubuntu 18.04 LTS or newer
  • Debian 10 or newer
  • RHEL/CentOS 7 or newer
  • Amazon Linux 2
  • Other distributions with glibc 2.17+

Dependencies:

  • glibc 2.17 or newer
  • OpenSSL 1.0.2 or newer
  • ca-certificates package

Verification and Post-Installation

Verify the installation by checking the version:

envv --version

Configure the shell completion (optional):

# Bash completion
envv completion bash > /etc/bash_completion.d/envv

# Zsh completion
envv completion zsh > "/usr/local/share/zsh/site-functions/_envv"

Test the installation by logging in with an API key from the dashboard:

envv login --token <YOUR_API_KEY>

envvault is also accepted as an alias for envv.

Troubleshooting

Common Issues and Solutions

Package Manager Issues

If you encounter GPG key errors:

# Debian/Ubuntu
sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys <key-id>

# RHEL/CentOS
sudo rpm --import https://packages.envvault.dev/gpg/

SSL/TLS Errors

If you encounter SSL certificate errors:

# Debian/Ubuntu
sudo apt install ca-certificates

# RHEL/CentOS
sudo yum install ca-certificates

Dependency Issues

For systems with older glibc versions:

# Check glibc version
ldd --version

# Install or update glibc (Debian/Ubuntu)
sudo apt update
sudo apt install libc6

# Install or update glibc (RHEL/CentOS)
sudo yum update glibc

Permission Issues

If you encounter permission denied errors:

# Fix binary permissions
sudo chmod 755 /usr/local/bin/envvault

# Fix ownership
sudo chown root:root /usr/local/bin/envvault

# Fix directory permissions if needed
sudo chmod 755 /usr/local/bin

Uninstallation

To remove EnvVault from your system:

Debian/Ubuntu:

sudo apt remove envvault
sudo rm /etc/apt/sources.list.d/envvault.list
sudo apt update

RHEL/CentOS:

sudo yum remove envvault
sudo rm /etc/yum.repos.d/envvault.repo

Manual installation:

sudo rm /usr/local/bin/envvault