diff --git a/docs/docs/installation/index.md b/docs/docs/installation/index.md index ee0b620b5..9031aa8c4 100644 --- a/docs/docs/installation/index.md +++ b/docs/docs/installation/index.md @@ -16,7 +16,7 @@ Follow the steps below to set up the server. If you want the `dstack` server to run containers or manage clusters in your cloud accounts (or use Kubernetes), create the [`~/.dstack/server/config.yml`](../reference/server/config.yml.md) file and configure backends. -### 2. Start the server +### 3. Start the server Once the `~/.dstack/server/config.yml` file is configured, proceed to start the server: @@ -55,13 +55,15 @@ Once the `~/.dstack/server/config.yml` file is configured, proceed to start the > For more details on how to deploy `dstack` using Docker, check its [Docker repo](https://hub.docker.com/r/dstackai/dstack). -By default, the `dstack` server stores its state in `~/.dstack/server/data` using SQLite. -To use a database, set the [`DSTACK_DATABASE_URL`](../reference/cli/index.md#environment-variables) environment variable. +By default, the `dstack` server stores its state in `~/.dstack/server/data` using SQLite, +while run logs are stored in `~/.dstack/server/projects//logs`. +To store the state in a database, set the [`DSTACK_DATABASE_URL`](../reference/cli/index.md#environment-variables) environment variable. +To store the logs in AWS CloudWatch, set the [`SERVER_CLOUDWATCH_LOG_GROUP`](../reference/cli/index.md#environment-variables) environment variable. The `dstack` server can run anywhere: on your laptop, a dedicated server, or in the cloud. Once it's up, you can use either the CLI or the API. -### 3. Set up the CLI +### 4. Set up the CLI To point the CLI to the `dstack` server, configure it with the server address, user token, and project name: @@ -81,8 +83,8 @@ Configuration is updated at ~/.dstack/config.yml This configuration is stored in `~/.dstack/config.yml`. -### 4. Create on-prem fleets - +### 5. Create on-prem fleets + If you want the `dstack` server to run containers on your on-prem servers, use [fleets](../fleets.md#__tabbed_1_2). @@ -95,4 +97,4 @@ use [fleets](../fleets.md#__tabbed_1_2). !!! info "dstack Sky" If you don't want to host the `dstack` server or would like to access GPU from the `dstack` marketplace, - check [dstack Sky](../guides/dstack-sky.md). \ No newline at end of file + check [dstack Sky](../guides/dstack-sky.md). diff --git a/docs/docs/reference/cli/index.md b/docs/docs/reference/cli/index.md index d13c25b6a..e7832775c 100644 --- a/docs/docs/reference/cli/index.md +++ b/docs/docs/reference/cli/index.md @@ -393,6 +393,8 @@ $ dstack pool delete --help * `DSTACK_SERVER_PORT` – (Optional) Has the same effect as `--port`. Defaults to `3000`. * `DSTACK_SERVER_ADMIN_TOKEN` – (Optional) Has the same effect as `--token`. Defaults to `None`. * `DSTACK_DATABASE_URL` – (Optional) The database URL to use instead of default SQLite. Currently `dstack` supports Postgres. Example: `postgresql+asyncpg://myuser:mypassword@localhost:5432/mydatabase`. Defaults to `None`. + * `SERVER_CLOUDWATCH_LOG_GROUP` – (Optional) The CloudWatch Logs group for workloads logs. If not set, the default file-based log storage is used. + * `SERVER_CLOUDWATCH_LOG_REGION` — (Optional) The CloudWatch Logs region. Defaults to `None`. * `DSTACK_SERVER_DIR` – (Optional) Sets path to store data and server configs. Defaults to `~/.dstack/server`. ??? info "Internal environment variables"