Managing services

Once you have created an Akka Serverless project, use the Akka Serverless Console or the akkasls CLI to deploy container images.

Akka Serverless services are automatically fault-tolerant and highly available. When you deploy a service, Akka Serverless creates multiple service instances. When the service load increases, Akka Serverless automatically scales up by adding more instances, and when the load decreases, it automatically scales down.


To deploy a service:

  1. Log in:

    1. In a command or terminal window, if you haven’t authorized akkasls, enter the following command:

      akkasls auth login

      The Akka Serverless Console opens in a browser window.

    2. If you are not logged into the Console, log in.

    3. Click Authorize.

      The akkasls prompt confirms the successful authorization attempt.

    4. Set your project to be the current Akka Serverless project:

      akkasls config set project <project name>

      Subsequent commands apply to the current project, as defined with config set project. Alternatively you can append --project <project name> to work with service commands.

  2. Deploy:


    Assuming a service name of my-service, enter the following:

    akkasls service deploy \
        my-service \

Verify service status

To verify the status of a service:


From the Dashboard, the Services card displays the Status of all services in a project:

Services card

Use the following command:

akkasls service list

A service status can be one of the following:

  • Ready: All service instances are up to date and fully available.

  • UpdateInProgress: Service is updating.

  • Unavailable: No service instances are available.

  • PartiallyReady: Some, but not all, service instances are available.

Update a deployed service

First, package and tag the changes to your service. When you redeploy, Akka Serverless performs a rolling update.

To re-deploy:

  • Update the deployed my-service service with a new package tagged tag-name-2:

    akkasls service deploy \
        my-service \

Removing a deployed service

Remove a deployed service using the CLI delete command. The following example removes a deployed service, where my-service is the service name:

akkasls service delete my-service