Skip to main content
Version: 0.8.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.