Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/kishnahai0806/SteelWorks/llms.txt

Use this file to discover all available pages before exploring further.

Render is the recommended hosting platform for SteelWorks, supporting Docker-based deployments and managed PostgreSQL out of the box. The SteelWorks CI pipeline triggers a Render deploy hook automatically whenever a push to main passes all tests.

Deploy the web service

1

Push your code to GitHub

Ensure your latest changes are committed and pushed to the main branch of your GitHub repository. The Render deployment pulls from this branch.
git push origin main
2

Create a new Web Service on Render

Log in to the Render dashboard and click New → Web Service.
3

Connect your GitHub repository

Select your GitHub account, then choose the SteelWorks repository. Set the branch to main.
4

Set Language to Docker

Under the Language selector, choose Docker. Render will detect the Dockerfile at the repository root and use it to build and run the service.
5

Add environment variables

Scroll to the Environment Variables section and add the following:
KeyValue
DATABASE_URLYour Render managed PostgreSQL connection string (see Managed PostgreSQL below)
SENTRY_DSNYour Sentry DSN — optional, omit entirely if not using Sentry
6

Deploy the service

Click Deploy Web Service. Render will build the Docker image, push it to its internal registry, and start the container.
7

Open your app

Once the deploy completes and the service status shows Live, open your service URL in a browser:
https://<your-service>.onrender.com/

Managed PostgreSQL

SteelWorks requires a PostgreSQL database. Render provides a managed PostgreSQL service that integrates cleanly with web services:
  1. In the Render dashboard click New → PostgreSQL.
  2. Choose a name, region, and plan, then click Create Database.
  3. Once the database is provisioned, open its detail page and copy the Internal Database URL (use the internal URL for services in the same Render region to avoid egress fees).
  4. Paste that URL as the value of the DATABASE_URL environment variable on your web service.
The connection string format used by SteelWorks is:
postgresql+pg8000://<user>:<password>@<host>/<dbname>
Keep SENTRY_DSN unquoted when entering it in the Render dashboard. Wrapping the value in quotation marks will cause the Sentry SDK initialization to fail because the quotes become part of the DSN string.
The Docker image listens on Render’s PORT environment variable. Render sets PORT automatically for every web service; the Dockerfile reads it via ${PORT} in the CMD instruction, so no manual port configuration is required.

Post-deploy checklist

After the service is live, run through the following steps to confirm everything is working correctly:
1

Verify the app is accessible

Open https://<your-service>.onrender.com/ and confirm the Operations Issue Metrics dashboard loads without errors.
2

Test the health endpoint

Confirm the Streamlit server is responding to health checks:
curl https://<your-service>.onrender.com/_stcore/health
A healthy server returns HTTP 200.

Build docs developers (and LLMs) love