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

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