Environment Configuration

Daytona supports multiple methods to configure your environment, in order of precedence:

1. Configuration in code
2. Environment variables
3. .env file
4. Default values

Configuration in code

To configure your environment in code, use the DaytonaConfig class. The DaytonaConfig class accepts the following parameters:

• api_key: Your Daytona API Key
• api_url: URL of your Daytona API
• target: Target region to create the Sandboxes on (us / eu)

Python

from daytona import DaytonaConfig

config = DaytonaConfig(
    api_key="YOUR_API_KEY",
    api_url="YOUR_API_URL",
    target="us"
)

TypeScript

import { DaytonaConfig } from '@daytona/sdk'

const config: DaytonaConfig = {
  apiKey: 'YOUR_API_KEY',
  apiUrl: 'YOUR_API_URL',
  target: 'us',
}

Ruby

require 'daytona'

config = Daytona::Config.new(
  api_key: 'YOUR_API_KEY',
  api_url: 'YOUR_API_URL',
  target: 'us'
)

Go

package main

import (
    "github.com/daytonaio/daytona/libs/sdk-go/pkg/daytona"
)

func main() {
    config := daytona.Config{
        APIKey: "YOUR_API_KEY",
        APIURL: "YOUR_API_URL",
        Target: "us",
    }

    client := daytona.NewClient(&config)
    _ = client
}

Java

import io.daytona.sdk.Daytona;
import io.daytona.sdk.DaytonaConfig;

public class App {
    public static void main(String[] args) {
        DaytonaConfig config = new DaytonaConfig.Builder()
            .apiKey("YOUR_API_KEY")
            .apiUrl("YOUR_API_URL")
            .target("us")
            .build();

        try (Daytona daytona = new Daytona(config)) {
            // Application code
        }
    }
}

API

curl https://app.daytona.io/api/api-keys \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '{
  "name": "",
  "permissions": [
    "write:registries"
  ],
  "expiresAt": ""
}'

Environment variables

Daytona supports environment variables for configuration. The SDK automatically looks for these environment variables:

Variable	Description	Required
DAYTONA_API_KEY	Your Daytona API key.	Yes
DAYTONA_API_URL	URL of your Daytona API.	No
DAYTONA_TARGET	Daytona Target to create the sandboxes on.	No

Shell

Set environment variables in your shell using the following methods:

Bash/Zsh

export DAYTONA_API_KEY=your-api-key
export DAYTONA_API_URL=https://your-api-url
export DAYTONA_TARGET=us

Windows PowerShell

$env:DAYTONA_API_KEY="your-api-key"
$env:DAYTONA_API_URL="https://your-api-url"
$env:DAYTONA_TARGET="us"

.env file

Set the environment variables in a .env file using the following format:

DAYTONA_API_KEY=YOUR_API_KEY
DAYTONA_API_URL=https://your_api_url
DAYTONA_TARGET=us

Async Python SDK

Daytona provides an additional DAYTONA_HAPPY_EYEBALLS_DELAY environment variable for HTTP transport tuning in the async Python SDK. Use it to reduce intermittent async connection failures, such as aiohttp.ClientConnectorError, that can occur on dual-stack (IPv4/IPv6) networks.

Variable	Description	Required
DAYTONA_HAPPY_EYEBALLS_DELAY	Controls aiohttp Happy Eyeballs (IPv4/IPv6 connection race) delay in seconds.	No

• unset or empty: use aiohttp default behavior
• none (case-insensitive): disable the IPv4/IPv6 race
• non-negative float (for example 0.25): set an explicit delay in seconds

# Disable Happy Eyeballs
export DAYTONA_HAPPY_EYEBALLS_DELAY=none

# Or set an explicit delay in seconds
export DAYTONA_HAPPY_EYEBALLS_DELAY=0.25

Default values

If no configuration is provided, Daytona will use its built-in default values:

Option	Value
API URL	https://app.daytona.io/api
Target	Default region for the organization