Skip to content

getting-started.md

Latest commit

 

History

History
143 lines (99 loc) · 3.63 KB

getting-started.md

File metadata and controls

143 lines (99 loc) · 3.63 KB
title Getting Started
description Install dtvem and get up and running in minutes.
order 0
category user-guide

Getting Started

Get dtvem installed and managing your runtimes in just a few minutes.

Installation (Preferred)

Standard Installation

Windows (PowerShell as Administrator):

irm dtvem.io/install.ps1 | iex

Requires administrator privileges. Adds dtvem to System PATH for all users.

macOS / Linux:

curl -fsSL dtvem.io/install.sh | bash

User Installation (No Admin Required)

Windows (PowerShell):

iex "& { $(irm dtvem.io/install.ps1) } -UserInstall"

Does not require administrator privileges. Adds dtvem to User PATH.

macOS / Linux:

curl -fsSL dtvem.io/install.sh | bash -s -- --user-install

Note: On Windows, System PATH is evaluated before User PATH. If you have system-installed runtimes (Node.js, Python, Ruby), they will take priority over dtvem-managed versions with user installation.

Default Locations

Platform Install Directory Shims Directory
Windows %USERPROFILE%\.dtvem %USERPROFILE%\.dtvem\shims
macOS ~/.dtvem ~/.dtvem/shims
Linux ~/.local/share/dtvem ~/.local/share/dtvem/shims

On all platforms, dtvem supports the XDG Base Directory Specification. If $XDG_DATA_HOME is set, dtvem uses $XDG_DATA_HOME/dtvem instead.

Custom Installation

Set DTVEM_ROOT before installing to use a custom location:

Windows (PowerShell as Administrator):

[Environment]::SetEnvironmentVariable("DTVEM_ROOT", "C:\dtvem", "Machine")
$env:DTVEM_ROOT = "C:\dtvem"
irm dtvem.io/install.ps1 | iex

macOS / Linux:

# Add to shell profile, then source it or restart terminal
export DTVEM_ROOT=/opt/dtvem
curl -fsSL dtvem.io/install.sh | bash

Manual Installation

  1. Download the latest release from GitHub Releases
  2. Extract the archive (contains dtvem and dtvem-shim)
  3. Move both binaries to a directory in your PATH (e.g., /usr/local/bin)
  4. Run dtvem init to configure your shell, then restart your terminal

Alternatively, you can place the binaries in any directory and manually add it to the beginning of your system PATH before running dtvem init.

Verify Installation

After installation, verify that dtvem is working:

> dtvem --version

Install a Runtime

Install a specific version of a runtime:

# Install Python 3.12
> dtvem install python 3.12.0

# Install Node.js 20
> dtvem install node 20.10.0

Set a Global Version

Set a default version to use system-wide:

> dtvem global python 3.12.0
> dtvem global node 20.10.0

Set a Project-Local Version

Pin versions for your project by creating a .dtvem/runtimes.json file:

> dtvem local python 3.12.0

This creates a config file that ensures everyone on your team uses the same version. Commit it to Git!

Bulk Install from Config

If your project already has a .dtvem/runtimes.json, install all runtimes at once:

> dtvem install

Check Current Versions

See which versions are active:

> dtvem current
> dtvem list python

Next Steps