Skip to main content
Version: 1.1.0


If you have not already installed epinio follow these links

In this tutorial, you will learn how to create a namespace and how to push, list and delete an application in it.

Push an application

Clone the sample app

If you just want an application that works use the one inside the sample-app directory.

You can copy it to your system with the following commands:

git clone
cd epinio/assets/

Push an app

There are two ways to push an application:

  1. You can provide an Application Manifest which contains the required configuration for the applications.
epinio push manifest.yaml
  1. You can provide the configuration as parameters in which case the parameter --name is mandatory. Because of the default route the name has to be unique across all namespaces.
epinio push --name sample --path sample-app

Note that the --path parameter is optional. If not specified the current working directory will be used. Always ensure that the chosen directory contains a supported application.

If you want to know what applications are supported in Epinio, please read the notes about supported applications.

We also provide information about the more advanced git model.

Note: If you want to know the details of the epinio push process, please read the detailed push docs

Check that your application is working

After the application has been pushed, a unique URL is printed which you can use to access your application. If you don't have this URL available anymore you can find it again by running:

epinio app show sample

("Routes" is the part your are looking for)

Go ahead and open the application route in your browser!

List all commands

To see all the applications you have deployed use the following command:

epinio apps list

Delete an application

To delete the application you just deployed run the following command:

epinio delete sample

Create a separate namespace

If you want to keep your various application separated, you can use the concept of namespaces. Create a new namespace with this command:

epinio namespace create newspace

To start deploying application to this new namespace you have to "target" it:

epinio target newspace

After this and until you target another namespace, whenever you run epinio push you will be deploying to this new namespace.