Configuring Static Files
Static File configuration is broken into two parts, the browser side address and the server side source. For this page, "Domain" refers to the Domain popup menu that lists Domains and Subdomains.
Web Address
First configure a web address the static files will be accessed from. Select a domain and optionally add a path. Static files configured with a domain but no path will prevent a Web App from running on that domain.
It is best practice to serve static files from a path on the same domain as the Xojo Web app. Lifeboat will set the default web path to serve out of a folder named "static" on the selected domain.
Some web paths are reserved for Xojo and can cause problems if you configure static files at these paths:
- /_* (anything that starts with an underscore)
- /api/
- /framework/
- /icons/
- /special/
- /xojo/
Source Path
Initially, the source path will be public_html under the user home folder. Lifeboat will suggest a source path specific to the selected domain when you click the "Suggest" button.
To access this location in Xojo code use SpecialFolder.UserHome.Child("public_html")
If a source directory does not yet exist Lifeboat may offer to create it. For Lifeboat to offer this feature, the path to the parent directory must exist.
Tab Details
Save the Changes
To save changes to the configuration click the "Save" button. Lifeboat will write and upload the nginx configuration. Changes will be lost by pressing the Cancel button or navigating away from the Static Files view.