Deployment options¶
Last reviewed: 2026-08-14
Deployment means running your website or API on a computer other people can reach.
I keep this page separate from the Course because hosting products and free limits change much faster than the RAG architecture.
BuildRAG website¶
BuildRAG is a static website. MkDocs turns the Markdown pages into HTML, CSS, and JavaScript files ahead of time. The host only needs to serve those files. It does not run Python for each visitor.
Cloudflare Pages can host the site on its free plan. The build command is:
uv run mkdocs build
MkDocs writes the finished website to the site/ directory.
Course API¶
A completed RAG API needs a computer that can run Python and a PostgreSQL database with pgvector.
Look for a host that can:
- run the FastAPI service continuously or start it when a request arrives;
- connect securely to PostgreSQL;
- send requests to your model provider;
- inject secrets through environment variables;
- record health checks and logs.
Neon and Supabase currently offer limited free PostgreSQL projects. Cloudflare Python Workers can run FastAPI, but not every Python package or database driver works in that environment. Test the exact Course dependencies before choosing it.
A free plan is useful for learning and previews. It does not promise that the service will always be available, and the provider may change its limits.