Skip to content

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.

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.