Login to a remote env

Log in only to deploy to or manage a remote Akka Platform environment, whether it runs at akka.io or is installed in your enterprise. Building, testing, and running locally need no login. To initiate the login process, run:

akka auth login

This command opens the Akka console login screen in your default web browser. The CLI will display Waiting for UI login…​ while you authenticate. Once authorization is complete, the CLI returns to the command prompt.

Upon successful authentication:

  • If you have one project, it is automatically set as the current project.

  • If no projects exist, you will need to create one and set it manually.

  • If you have multiple projects, you will need to specify the target project manually (see below).

To set your current project:

akka config set project my-project

For more authentication options:

akka auth -h

You can also refer to the auth page.

Behind a corporate proxy

In corporate environments with HTTP proxy servers that do not support HTTP/2, you may encounter issues since the akka CLI uses gRPC. To bypass these limitations, you can configure the CLI to use grpc-web, which works over HTTP/1.1 and HTTP/2.

Log in with grpc-web enabled:

akka auth login --use-grpc-web

If you are already logged in but need to switch to grpc-web, configure it with:

akka config set api-server-use-grpc-web true

Related documentation