Xojo Cloud troubleshooting

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. Enter a domain name or subdomain in the Domain Name field.

  5. 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. Choose Restart from the Action menu 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. Choose Refresh Apps from the Action menu 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?

If you entered a full domain name in the Domain Name field in the Inspector, you should be able to enter that into a browser. If you entered just a name (not a full domain name) then that name became a subdomain of xojocloud.net. For example, if you entered "MyApp", then you would use myapp.xojo.cloud.net to access your application.

Alternatively, you can use the server's IP address in combination with your app name. For example: http://111.222.333.444/MyWebApp/

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 Cloud Top project uses the Unix Top command to display usage. The project is found with the Xojo Examples which you can compile and deploy to your Xojo Cloud server:

Platforms/Web/Xojo Cloud Top

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.

Text I'm drawing to graphics does not appear

The most likely reason is that the font you are using doesn't exist on the server. Try using SFTP to upload the font to the Font folder.