CLI Reference

Running

Run

Runs your application.

encore run [--debug] [--watch=true] [flags]

Test

Tests your application

Takes all the same flags as go test.

encore test ./... [go test flags]

Check

Checks your application for compile-time errors using Encore's compiler.

encore check

App

Commands to create and link Encore apps

Clone

Clone an Encore app to your computer

encore app clone [app-id] [directory]

Create

Create a new Encore app

encore app create [name]

Link

Link an Encore app with the server

encore app link [app-id]

Auth

Commands to authenticate with Encore

encore auth login

Logout

Logs out the currently logged in user

encore auth logout

Create a new Encore account

encore auth signup

Whoami

Show the current logged in user

encore auth whoami

Database Management

Database management commands

Connection URI

Outputs the database connection string

encore db conn-uri [servicename] [flags]

Proxy

Sets up a proxy tunnel to the database

encore db proxy [--env=<name>] [flags]

Reset

Resets the databases for the given services. Use --all to reset all databases.

encore db reset [service-names...] [flags]

Shell

Connects to the database via psql shell

Defaults to connecting to your local environment. Specify --env to connect to another environment.

encore db shell [service-name] [--env=local]

Code Generation

Code generation commands

Generate client

Generates an API client for your app. For more information about the generated clients, see this page.

By default generates the API based on your primary production environment. Use '--env=local' to generate it based on your local development version of the app.

Supported language codes are:

go: A Go client using the net/http package
typescript: A TypeScript-client using the in-browser Fetch API

encore gen client <app-id> [--env=prod] [flags]

Logs

Streams logs from your application

encore logs [--env=prod] [--json]

Secrets Management

Secret management commands

Set

Sets a secret value

encore secret set --dev|prod <key>

Examples

Entering a secret directly in terminal:

$ encore secret set --dev MySecret
Enter secret value: ...
Successfully created development secret MySecret.

Piping a secret from a file:

$ encore secret set --dev MySecret < my-secret.txt
Successfully created development secret MySecret.

Note that this strips trailing newlines from the secret value.

Version

Reports the current version of the encore application

encore version

Update

Checks for an update of encore and, if one is available, runs the appropriate command to update it.

encore version update

VPN

VPN management commands

Start

Sets up a secure connection to private environments

encore vpn start

Status

Determines the status of the VPN connection

encore vpn status

Stop

Stops the VPN connection

encore vpn stop