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:
nctl logs app {application_name} --followSee 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:
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:
nctl get app {application_name} --dnsThe technical reference has more details about custom hostname configuration.
Which revision is live?
nctl get app {application_name} --output yaml | grep revisionPrints 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:
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:
nctl get releases
nctl get build {build_name} -o yaml | grep revisionFor 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:
- List builds
nctl get builds --application-name {application_name}- Pull image for a specific build
nctl get builds {build_name} --application-name {application_name} --pull-imageYou can also see the full configuration of the build by running:
nctl get builds {build_name} --application-name {application_name} --output jsonDeploio 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:
- Email: support@nine.ch
- Phone: +41 44 637 40 40
- Support portal: https://portal.nine.ch/
Further documentation
In case our guides don't cover your issue or question, we provide further documentation here.