Skip to content

init.md

Latest commit

 

History

History
106 lines (76 loc) · 2.31 KB

init.md

File metadata and controls

106 lines (76 loc) · 2.31 KB
title init
description Initialize dtvem on your system.
order 13
category user-guide
parent Commands Reference

init

Initialize dtvem on your system.

Usage

> dtvem init
> dtvem init --yes
> dtvem init --user

Flags

Flag Description
--user Use User PATH instead of System PATH (Windows: no admin required)
--yes, -y Skip confirmation prompts

Behavior

  1. Creates the dtvem directory structure
  2. Configures PATH to include ~/.dtvem/shims
    • Standard: Adds to System PATH (requires admin on Windows)
    • User (--user): Adds to User PATH (no admin required)
  3. Updates shell configuration files as needed

Directory Structure Created

~/.dtvem/
├── shims/       # Shim executables (added to PATH)
├── versions/    # Installed runtime versions
├── config/      # Global configuration
└── cache/       # Cached data

Shell Configuration

dtvem init updates your shell configuration to add shims to PATH:

Shell Configuration File
Bash ~/.bashrc
Zsh ~/.zshrc
Fish ~/.config/fish/config.fish
PowerShell $PROFILE

Examples

# Interactive initialization (standard)
> dtvem init
Creating dtvem directory structure...
Add ~/.dtvem/shims to PATH? [Y/n] y
Updating ~/.bashrc...

✓ dtvem initialized!

Restart your terminal, then run:
  dtvem install python 3.12.0
  dtvem global python 3.12.0

# Non-interactive initialization
> dtvem init --yes

# User installation (no admin required on Windows)
> dtvem init --user

Post-Init Steps

After running dtvem init:

  1. Restart your terminal — Required for PATH changes
  2. Install a runtime — dtvem install python 3.12.0
  3. Set global version — dtvem global python 3.12.0

Switching Install Types

You can switch between standard and user installation by running dtvem init again:

# Switch to user install
> dtvem init --user

# Switch back to system install (requires admin)
> dtvem init

When switching, dtvem will warn about cleaning up the old PATH entry.

See Also