Skip to main content

Hosting

Host your application on Marblism.

https://app.marblism.com/hosting
hosting-deploy

How does it work​

1. App Build​

The first step builds your app using the command pnpm run build.

Common Errors​

Some errors only occur when you deploy your project for hosting. To troubleshoot follow these steps:

  1. Launch a Workspace
  2. Navigate to the Editor tab
  3. Open a terminal
    https://app.marblism.com/hosting
    editor terminal
  4. Run pnpm run build. This will show logs of all the issues/bugs within your app, usually with details such as the file path and line number of the error.
  5. Attempt to fix the errors and if you're still facing issues open a thread in the #help channel on Discord.

2. Database​

Marblism automatically configures a PostgreSQL database. The database URL is accessible from your environment variables.

You can download a database browser like Postico or PgAdmin to manage your production database (for example to add yourself as Admin User).

Database backups are created automatically every 3 days and are retained for 14 days.

https://app.marblism.com/hosting
database backup

3. Domain​

You have the option to use a sub-domain of app.io provided by Marblism, or your own custom domain.

Provided subdomain​

By default, your provided sub-domain will be set to your Project ID. You can edit as required.

https://app.marblism.com/hosting
subdomain

Custom domain​

Follow these steps to setup your own custom domain as the URL to your app.

  1. Enter your custom domain and click Register.
https://app.marblism.com/hosting
custom-domain-create
  1. Create the necessary DNS records through your DNS provider dashboard.
https://app.marblism.com/hosting
custom-domain-success
  1. (Optional) Restart your app.

If your app was running when configuring your sub-domain or setting up your own custom domain, you will need to restart it for the changes to take effect.

Common Errors​

Custom Domain​

  • 503 Service Unavailable Error

    Solution: Make sure that the DNS record of type = CNAME and name = www has been created on your DNS provider dashboard.

  • Your connection is not private

    Solution: Make sure that the DNS record of type = CNAME and value = _XXXXXXXXXX..acm-validations.aws. has been created on your DNS provider dashboard.

    Note: You might need to wait a few minutes after creating this record for your SSL certificate to be validated.

4. Infrastructure​

Finally, your infrastructure is created and available on your chosen domain.

https://app.marblism.com/hosting
deployed

By default, your monorepo starts your web and server applications with the correct settings.

In case you've changed it, check the following

  • Web package starts on port 8099
  • Server package starts on port 3099

5. Maintenance​

Deploy Latest Version​

Builds from the #main branch and releases a new version.

Restart Current Version​

Retains the currently deployed version - useful for updating environment variables.

Environment Variables​

By default, Marblism takes care of everything. All required variables are created and protected.

The SERVER_AUTHENTICATION_SECRET is generated automatically for your security. You can update this secret at any time if needed.

If your app uses emails, AI or file upload, make sure to add the relevant environment variables.

https://app.marblism.com/hosting
environment variables