Deploio Guides

Appearance

Troubleshooting ​

Should you have an issue with your application, we have a few tools and guides to help you get back on track.

Logs ​

If you want to debug a runtime error, you could start by looking at the latest logs of your application. Use the following command:

bash
nctl logs app {application_name} --follow

See the Monitoring and Logs section for more information.

Where does it run? ​

To find out under which domain name your app is reachable, you can print a list of verified and unverified hosts:

bash
nctl get app {application_name}

If you see entries as "unverified", you need to configure your DNS server. Therefore you can print the DNS target configuration:

bash
nctl get app {application_name} --dns

The technical reference has more details about custom hostname configuration.

Which revision is live? ​

bash
nctl get app {application_name} --output yaml | grep revision

Prints the revision of the latest deployment. Use this revision to find the corresponding git commit in the git history.

Run a command in all your apps ​

If you have many apps you might need to run a command in a container for each application. Use a shell script with nctl to generate a list of commands for you:

For example if you want to check your libvips version for all your apps:

bash
nctl get apps -A -o no-header | while read -r project app _; do
  printf '%s\n' "nctl exec app $app -p $project --stdin=false -- bash -c \
    'dpkg -l | grep libvips'"
done

Double-check the output before running. Maybe try it on a few apps at first. The example above assumes a Debian build with dpkg available.

Database ​

Access ​

This guide describes how you can access a database directly from your local machine. In case you receive a connection error, make sure that your local IP address is allow-listed in the database configuration. See the Configuring your database guide for more information.

Backups ​

See the Database Backups guide for instructions on how to create and restore database backups.

Rollback deployments ​

In case you want to rollback to a previous revision, you can use the following command:

bash
nctl update app {application_name} --git-revision={git_revision}

If you're not sure which revision was live, you can find out by looking at release and build information:

bash
nctl get releases
nctl get build {build_name} -o yaml | grep revision

For rolling back to the previous release you would choose the build of the most recent "superseded" release.

Kubernetes ​

In case you want to reproduce an issue with a certain build, you can use the following commands to pull the corresponding image and run it locally with Docker or podman:

  1. List builds
bash
nctl get builds --application-name {application_name}
  1. Pull image for a specific build
bash
nctl get builds {build_name} --application-name {application_name} --pull-image

You can also see the full configuration of the build by running:

bash
nctl get builds {build_name} --application-name {application_name} --output json

Deploio system status ​

We provide further information about the status of our system and services on our status page.

Support ​

Should you have any other questions or issues, please reach out to us via the following channels.

Slack Community ​

We do have an official Deploio Slack community. We'll try to answer your questions as soon as possible.

Contact ​

Next to the Slack community, you can reach us via the following ways:

Further documentation ​

In case our guides don't cover your issue or question, we provide further documentation here.