▪️ Authentication with GitHub

1

Failed to Authenticate with GitHub

Solution: Grant the necessary permissions for Preswald to access your GitHub account. - Go to GitHub SettingsApplicationsAuthorized OAuth Apps and confirm that Preswald has the required repository permissions. - If authentication still fails, try logging out of Preswald and logging back in.

2

GitHub Account Not Found

Solution: Verify that you’re using the correct GitHub account. Verify that the account has access to the repository you’re trying to import.

If the issue persists, contact Preswald support for assistance.

▪️ Importing a Repository with a Config File

1

Repository Not Found

Solution: Verify the repository is public or that your GitHub account has access to it. For private repos, confirm that you’ve granted the required permissions during GitHub authentication.

2

Config File Not Detected

Solution: Verify that your repository contains a valid config.toml file in the root directory. Check for typos or misplacement of the file.

3

Import Fails with an Error

Solution: Review the error logs in the Preswald dashboard for details. Common issues include missing dependencies or unsupported configurations. Update the config.toml file as needed and re-import the repository.

▪️ Creating an App

1

App Fails to Initialize

Solution: Check the config.toml file for missing or invalid fields, such as title, port, or data connections. Update the config.toml to be valid.

2

Error in App Code

Solution: Run a local version of your app using preswald run before deploying it in the cloud. Fix any errors or syntax issues in your codebase.

For more detailed debugging, view your app’s logs in the Preswald dashboard.

▪️ Deploying an Endpoint

1

Deployment Fails

Solution: Confirm that your secrets.toml file contains valid cloud credentials for your hosting platform (e.g., Google Cloud, AWS). Check for typos or missing fields.

2

Endpoint Not Accessible

Solution: Verify that the deployment URL is correct and that your app is running. Check for firewall or network restrictions that might block traffic to your endpoint.

Use the deployment logs in the dashboard to identify specific issues during deployment.

▪️ Setting Up Authentication for an App

1

Auth Configuration Errors

Solution: Verify the auth section in your config.toml file. Correctly set up authentication providers (e.g., GitHub) and provide valid client IDs and secrets.

2

Users Unable to Log In

Solution: Check the authentication provider’s settings. Correctly configure app’s redirect URI. For example, make sure it matches the Preswald app’s domain and endpoint.

Test your authentication setup using multiple accounts to make sure everything works as expected.

▪️ Sharing a Workspace with Teammates

1

Unable to Share Workspace

Solution: Only organization admins can invite collaborators. If you’re not the workspace owner, contact the owner to manage sharing settings.

2

Invitation Not Received

Solution: Verify the email address or GitHub account of the teammate you’re inviting. Ask them to check their spam folder or notification settings.

3

Collaborators Can’t Access Resources

Solution: Check that the invited teammates have the correct roles and permissions. Use the Preswald dashboard to update roles if necessary.

Use the Workspace Settings page to review sharing configurations and permissions.

Summary

Troubleshooting Structured often comes down to checking permissions, configurations, and logs. For persistent issues, contact support@structuredlabs.com for help.