Skip to content

Apps

Create new app

To create a new app, run the following command:

simplifyd create app
You would be prompted to enter an app and project name and also environment variables. Environment variables are optional and not required. Environment variables are specified in the form: VARIABLE1=VALUE1,VARIABLE2=VALUE2.

Note that this is a replace operation not a modify operation. The current environment variables would be replaced entirely by the new ones specified with this command.

Environment variables created at the app level apply only to the app and not to other apps within the project. This is different from creating environment at the project level, where it applies to all apps and services created within the project.

Another way to provide the arguments needed by the parameters of the create app command is like this:

simplifyd create app --name example-app --project example-project --env APP_USER=test,APP_DOMAIN=example.com

This is more suited for situations where you need to run the commands in scripted or automated environments.

List all created apps

If app creation was successful, you can now list all apps by running the following command:

simplifyd list apps

Deploy/Publish app

To deploy an app, run the following command:

simplifyd deploy app
This command starts a build process. The source code is cloned from the specified git repo and turned into a build artifact. THe build artifact is then deployed on a runner. A Simplifyd vanity URL is associated with your deployed app so that you can view it in a browser. Note that deploying an app consumes resources that you would be charged for. Listing apps shows the status of the app and the Simplifyd vanity URL if the app has been deployed.

Rollback an app

In the event that you need to roll back an app to a previous version, run the following command:

simplifyd rollback app
You would need to specify the id of a previous build aritifact that you want to rollback to. To view a list of previous build artifacts, run the following command: simplifyd list artifacts.

Update environment variables of app

To update the environment variables of an app, run the following command:

simplifyd patchApp env
Note that this is a replace operation not a modify operation. The current environment variables would be replaced entirely by the new ones specified with this command.

Add custom domain

To add a custom domain to an already deployed app, run the following command:

simplifyd add domain
For the command to be successful, you must have configured your DNS settings properly. You need to add a CNAME where you point your custom domain to the Simplifyd domain shown. When this is done, you should be able to now access the app on the custom domain you provided. SSL certificates would be handled automatically by Simplifyd. In some rare cases you might need to wait for up to 5 minutes for the process to complete.

Delete created app

To delete an app, run the following command:

simplifyd delete app