Xojo Cloud Troubleshooting

From Xojo Documentation

Revision as of 19:42, 28 September 2018 by PLefebvre (talk | contribs) (Created page with "== How do I deploy my web application to Xojo Cloud? == In the Xojo IDE: # Click on the Xojo Cloud option in Build Settings. # Choose your server from the Server popup menu in...")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

How do I deploy my web application to Xojo Cloud?

In the Xojo IDE:

  1. Click on the Xojo Cloud option in Build Settings.
  2. Choose your server from the Server popup menu in the Inspector.
  3. If your server does not appear in the popup menu, see the question “How do I make my server appear in the Xojo IDE?” below.
  4. Once you have selected your server, click the Deploy button in the Xojo IDE toolbar.

How do I make my Xojo Cloud server appear in the Xojo IDE?

  1. In the Xojo IDE, click on Xojo Cloud in Build Settings.
  2. If the name of your server doesn’t appear in the Server popup menu, choose Refresh List from that popup menu.
  3. If it still does not appear and you just ordered your server, wait 5 minutes as it may not be ready yet.
  4. If after waiting it still does not appear, contact Support.

I get an error when trying to Deploy to my Xojo Cloud server. What should I do?

  1. Go to the Xojo Cloud control panel.
  2. Click the Restart button below the name of the server you wish to restart.
  3. Wait 5 minutes for the server to restart and startup all of its services.
  4. Once it has restarted, upload a simple “Hello World” test application to verify that it’s working.
  5. If that succeeds, upload your project.
  6. Click the List Apps button on the Xojo Cloud control panel to verify it uploaded successfully. If it appears but it's not accessible, the app is likely crashing on launch.
  7. If it won’t launch or is crashing on launch consider:
    • Have you recently added a new plugin that might not support Linux?
    • Have you made any code changes - especially any that would run at application startup?
    • Have you recently installed an SSL certificate? It could be that didn’t install correctly.
    • If you haven’t already, implement the WebApplication.UnhandledException event so you can see if the app is getting an unhandled exception on startup.

What is the IP address of my server?

It is shown in the Xojo Cloud control panel.

How do I access my deployed web application?

The URL is a combination of your server IP address followed by the app name. For example:


Your app may be named MyWebApp-Dev if the Development State property of your project is set to Development. You can change this in the Shared Build Settings.

Where should I put files that my application uses?

The files should be placed in the Documents or SharedDocuments folders using the SpecialFolder module.

You can use SFTP to access these folders to upload or download files once you have enabled the tunnel and SFTP in the Xojo Cloud Control Panel.

Why am I getting a mutex error when trying to view my application?

This means that your application is crashing or quitting unexpectedly. Xojo Cloud creates a mutex file as a flag of sorts to prevent Apache from launching a new instance of your app for every session. When your application quits, the mutex file is deleted. If your application crashes, the mutex file is not deleted because your application didn’t quit, it crashed.

The next step is to figure out why the application is crashing. It could be crashing because:

  • An unhandled exception. Implement the WebApplication.UnhandledException event and see if that’s occurring.
  • Because your application has run out of memory. This would suggest you have a memory leak meaning that the app is using memory and never releasing it.
  • There’s a crashing bug in your code, in the Xojo framework or in a plugin you are using.

How can I redirect my domain to a Xojo Cloud web application?

You can find information on how to do that on the Xojo Cloud General Information page.

How can I Add, Connect and Manage my database?

You can find information on how to do that on the Xojo Cloud Control Panel page.

How can I see how much memory my applications are using and how much disk space I have used?

The Xojo CloudTop project uses the Unix Top command to display usage. The project is included with your Xojo installation in the Examples folder which you can compile and deploy to your Xojo Cloud server:

Examples/Xojo Cloud/CloudTop

Or you can download the Xojo Cloud top project.

How can I get access to log files on the server?

Log in to your Xojo Cloud account using SFTP and then navigate to the root and open the logs directory to see log files.

How can I keep my Xojo Cloud web app from quitting when no one is connected?

Xojo Cloud apps are CGI web apps. By default CGI web apps quit after a short time when there are no users connected. You can override this by changing the AutoQuit property in your WebApplication.Open event:

App.AutoQuit = False