​

vers init

​

Usage

vers init                                    # Initialize with defaults
vers init --name my-project                  # Set custom project name
vers init --mem-size 1024 --vcpu-count 2     # Override VM settings

​

Options

​

Examples

​

Initialize with defaults

vers init

​

Customize project settings

vers init --name my-web-app --mem-size 1024 --vcpu-count 2

​

Machine learning project

vers init --name ml-experiment --mem-size 2048 --vcpu-count 4

​

What gets created

​

Configuration file (vers.toml)

[machine]
mem_size_mib = 512
vcpu_count = 1
fs_size_mib = 512

[rootfs]
name = "my-project"

[kernel]
name = "default.bin"

​

Repository structure (.vers/)

.vers/
├── HEAD              # Current VM pointer (initially empty)
└── logs/             # Log storage

​

Git integration (.gitignore)

​

How it works

1. Authentication check: Prompts for login if no API key exists
2. Directory creation: Creates .vers/ directory structure
3. Configuration: Generates vers.toml with specified or default values
4. Git integration: Creates/updates .gitignore with Vers-specific entries
5. Local setup: Initializes empty HEAD file

​

Authentication

vers init
# Prompts for login if not already authenticated

​

Configuration details

• [machine]: VM resource allocation (memory, CPU, storage)
• [rootfs]: Base filesystem image configuration
• [kernel]: Kernel image specification

​

Prerequisites

• Write permissions in the current directory
• Network connectivity for authentication (if not already logged in)

​

Common Patterns

​

New project, fast path

mkdir my-project && cd my-project
vers init
vers run --wait

​

Init with custom sizing baked in

vers init --mem-size 4096 --vcpu-count 4 --fs-size-vm 4096

​

Re-init an existing directory

rm vers.toml
vers init --mem-size 2048

​

See Also

• vers run - Start your environment after initialization
• vers login - Authenticate with Vers platform