Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 8 additions & 0 deletions deploy/getting_started.md
Original file line number Diff line number Diff line change
Expand Up @@ -35,6 +35,14 @@ An application is a single deployed web service with one build configuration,
build history, environment variables, attached custom domains, a linked GitHub
repository, etc.

:::info

You can also create and configure apps from the command line with
`deno deploy create`. See the
[Apps reference](/deploy/reference/apps/#using-the-cli) for details.

:::

## Select a repo

1. Choose the GitHub repository for your application:
Expand Down
54 changes: 49 additions & 5 deletions deploy/reference/apps.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,17 +12,20 @@ organization and is used in default domain names.

## Creating an application

To create an application:
Applications can be created from the
[Deno Deploy dashboard](https://dash.deno.com) or from the command line using
the [`deno deploy` CLI](/runtime/reference/cli/deploy/).

1. Click the "+ Create App" button on the organization page
### Using the dashboard

To create an application from the web dashboard:

1. Click the "+ New App" button on the Application overview page
2. Select the GitHub repository to deploy from
3. Configure the app slug (name)
4. Set up build configuration
5. Add any required environment variables

> ⚠️ Currently, applications must be linked to a GitHub repository during
> creation.

The build configuration determines how the application is built during the
deployment process. Builds are automatically triggered on each push to the
linked repository or when manually clicking "Deploy Default Branch". For
Expand All @@ -34,6 +37,47 @@ Environment Variables". For more details on environment variables, see the
[Environment Variables and Contexts](/deploy/reference/env_vars_and_contexts/)
documentation.

### Using the CLI

You can also create applications from the command line with
`deno deploy create`. Running without flags starts an interactive wizard that
walks you through each step:

```bash
deno deploy create
```

For CI/CD pipelines or scripting, provide flags to skip the wizard entirely:

```bash
deno deploy create \
--org my-org \
--app my-api \
--source local \
--framework-preset fresh \
--build-timeout 5 \
--build-memory-limit 1024 \
--region us
```

You can also create apps that deploy from a GitHub repository:

```bash
deno deploy create \
--org my-org \
--app my-app \
--source github \
--owner my-github-org \
--repo my-repo \
--framework-preset astro \
--build-timeout 10 \
--build-memory-limit 2048 \
--region global
```

For the full list of flags and options, see the
[`deno deploy create` CLI reference](/runtime/reference/cli/deploy/#create-application).

## Renaming an application

Applications can be renamed by editing the app slug on the app settings page.
Expand Down
Loading