One post tagged with "Deployment"

Pycora Pro outputs pure static HTML. That means you can host it for free on Cloudflare Pages — unlimited bandwidth, automatic HTTPS, and continuous deployment from GitHub.

Here's the full walkthrough.

Prerequisites​

• Pycora Pro installed locally
• A GitHub account
• A Cloudflare account (free)

Step 1 — Push to GitHub​

If your project isn't on GitHub yet:

git init
git add .
git commit -m "initial commit"
git remote add origin https://github.com/YOUR_USERNAME/pycora-site.git
git push -u origin main

Step 2 — Test the Build Locally​

Before deploying, make sure the build works:

python ssg.py

You should see:

Ready in 0.87s - 41 files - MEDUSA v2.4.6

The output/ folder now contains your static site.

Step 3 — Connect to Cloudflare Pages​

1. Go to pages.cloudflare.com
2. Click Create a project
3. Click Connect to Git
4. Authorize Cloudflare to access your GitHub account
5. Select your repository

Step 4 — Configure Build Settings​

Important: Cloudflare needs Python 3.8+ in the build environment. Cloudflare Pages has Python pre-installed.

Environment Variables (Optional)​

If your ssg.py needs any environment variables:

Step 5 — Deploy​

Click Save and Deploy.

Cloudflare will:

1. Clone your repository
2. Install Python dependencies
3. Run python ssg.py
4. Upload output/ to their CDN
5. Give you a URL like https://pycora-site.pages.dev

First deploy takes 1–2 minutes. Subsequent deploys are faster.

Step 6 — Add a Custom Domain​

1. Go to your project → Custom domains
2. Click Set up a custom domain
3. Enter your domain (e.g. pycora.axcora.com)
4. Follow the DNS instructions

If your domain is already on Cloudflare, DNS is configured automatically.

Step 7 — Automatic HTTPS​

Cloudflare provisions an SSL certificate automatically. No configuration needed.

Your site is now available at https://yourdomain.com with:

• ✅ Automatic HTTPS
• ✅ HTTP/3 support
• ✅ Global CDN
• ✅ Unlimited bandwidth
• ✅ DDoS protection

Continuous Deployment​

Every push to main triggers a new deploy:

git add .
git commit -m "update homepage"
git push

Cloudflare rebuilds and deploys automatically. You get a preview URL for every commit.

Troubleshooting​

Build fails with "python: not found"​

Add a .python-version file to your repo:

3.11

Or set PYTHON_VERSION in environment variables.

Build succeeds but pages are blank​

Check that content/index.md exists and has valid frontmatter. Run python ssg.py locally and check for errors.

404 on subpages​

Cloudflare Pages handles trailing slashes automatically. If you have issues, add a _redirects file:

/*    /index.html   200

Alternative Providers​

Cost Comparison​

Pycora Pro pays for itself in under 6 months.

Get Pycora Pro​

Ready to deploy? Get Pycora Pro on Gumroad — one payment, own forever.

Next Steps​

• Configuration
• Content Creation
• Customization