> ## Documentation Index
> Fetch the complete documentation index at: https://developer.upsun.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Hands-On

![Run an AI Log-Analysis Agent in an Upsun Task Container](https://developer.upsun.com/images/posts/devcenter.webp)

tutorials

Tuesday, September 1st 2026

### [Run an AI Log-Analysis Agent in an Upsun Task Container](https://developer.upsun.com/posts/tutorials/ai-log-analysis-agent-in-an-upsun-task-container)

Reuse the cron-triggers-a-task pattern to run an OpenCode AI agent inside an Upsun task container. The agent reads your cron and application logs, analyzes them, and writes a Markdown health report to the task logs and a temporary file.

![Offload Heavy Jobs to Upsun Task Containers, Triggered by Cron](https://developer.upsun.com/images/posts/devcenter.webp)

tutorials

Thursday, August 20th 2026

### [Offload Heavy Jobs to Upsun Task Containers, Triggered by Cron](https://developer.upsun.com/posts/tutorials/offload-heavy-jobs-to-upsun-task-containers-with-cron)

Move long, resource-hungry jobs out of your crons and into on-demand Upsun task containers. Learn how to define a task, authorize your app to trigger it, and fire it from a lightweight cron for database imports or search reindexing.

![CiviCRM with WordPress Bedrock on Upsun](https://developer.upsun.com/images/posts/hands-on/civicrm-drupal-11-on-upsun/UpsunxSkvare-800x300.webp)

hands-on

Tuesday, June 30th 2026

### [CiviCRM with WordPress Bedrock on Upsun](https://developer.upsun.com/posts/hands-on/civicrm-with-wordpress-bedrock-on-upsun)

A guide to deploying CiviCRM on top of a Bedrock-based WordPress installation on Upsun, utilizing an optimized Composer template and MariaDB schemas.

![Scale n8n with PostgreSQL and Redis on Upsun](https://developer.upsun.com/images/posts/use-cases/n8n-upgrade-postgresql-redis/n8n-postgresql-redis-thumbnail.svg)

hands-on

Wednesday, April 29th 2026

### [Scale n8n with PostgreSQL and Redis on Upsun](https://developer.upsun.com/posts/use-cases/n8n-upgrade-with-postgresql-and-redis)

Upgrade your n8n instance from SQLite to PostgreSQL and add Redis caching for better performance, scalability, and reliability. Step-by-step guide for Upsun.

![That cron should be a worker](https://developer.upsun.com/images/posts/hands-on/that-cron-should-be-a-worker/that-cron-should-be-a-worker.webp)

hands-on

Wednesday, March 4th 2026

### [That cron should be a worker](https://developer.upsun.com/posts/hands-on/that-cron-should-be-a-worker)

Long-running crons block your deployments, steal resources from your app container, and create support tickets. Here's when to use workers instead.

![From DrupalCon keynote to live Upsun demo: the real story of setting up Drupal Canvas with AI](https://developer.upsun.com/images/posts/hands-on/the-real-story-of-setting-up-drupal-canvas-with-ai/lemberg-setting-up-drupal-canvas-with-ai.webp)

hands-on

Friday, February 13th 2026

### [From DrupalCon keynote to live Upsun demo: the real story of setting up Drupal Canvas with AI](https://developer.upsun.com/posts/hands-on/the-real-story-of-setting-up-drupal-canvas-with-ai)

Discover how the Lemberg Solutions team set up Drupal Canvas with an AI assistant: how long it took, the challenges we faced and lessons we learned.

![Scriberr on Upsun](https://developer.upsun.com/images/posts/hands-on/scriberr-on-upsun/scriberr-on-upsun.webp)

hands-on

Tuesday, February 10th 2026

### [Scriberr on Upsun](https://developer.upsun.com/posts/hands-on/scriberr-on-upsun)

Learn how to deploy Scriberr, an AI-powered transcription tool, on Upsun for self-hosted audio and video transcription.

![Unstable website? Use queues.](https://developer.upsun.com/images/posts/hands-on/unstable-website-use-queues/unstable-website-use-queues.webp)

hands-on

Thursday, February 5th 2026

### [Unstable website? Use queues.](https://developer.upsun.com/posts/hands-on/unstable-website-use-queues)

Your site throws 502 errors when external APIs are slow. The fix isn't more resources. It's offloading that work to background jobs so your responses stay fast.

![How to Use Harlequin SQL IDE with Upsun](https://developer.upsun.com/images/posts/hands-on/how-to-use-harlequin-sql-ide-with-upsun/harlequin-interface.webp)

hands-on

Wednesday, January 14th 2026

### [How to Use Harlequin SQL IDE with Upsun](https://developer.upsun.com/posts/hands-on/how-to-use-harlequin-sql-ide-with-upsun)

Learn two ways to connect Harlequin SQL IDE to your Upsun PostgreSQL database: using local SSH tunnels or deploying Harlequin directly on the platform.

![Stop testing JCR apps in production](https://developer.upsun.com/images/posts/hands-on/stop-testing-jcr-apps-in-production/stop-testing-jcr-apps-in-production.webp)

hands-on

Tuesday, January 6th 2026

### [Stop testing JCR apps in production](https://developer.upsun.com/posts/hands-on/stop-testing-jcr-apps-in-production)

Learn why JCR-based applications benefit from fast, production-grade environment cloning. Discover how Upsun removes one of JCR's biggest operational challenges through instant repository duplication.

![Installing CiviCRM with Drupal 11 on Upsun](https://developer.upsun.com/images/posts/hands-on/civicrm-drupal-11-on-upsun/UpsunxSkvare-800x300.webp)

hands-on

Friday, December 19th 2025

### [Installing CiviCRM with Drupal 11 on Upsun](https://developer.upsun.com/posts/hands-on/civicrm-drupal-11-on-upsun)

Learn how to install CiviCRM with Drupal 11 on Upsun, from config.yml and databases to cron, caching, extensions and Skvare’s best-practice template.

![Migration day: executing your Upsun cutover](https://developer.upsun.com/images/posts/hands-on/migration-day-executing-your-upsun-cutover/migration-day-executing-your-upsun-cutover.webp)

hands-on

Tuesday, December 16th 2025

### [Migration day: executing your Upsun cutover](https://developer.upsun.com/posts/hands-on/migration-day-executing-your-upsun-cutover)

A step-by-step guide to migration day: maintenance windows, cutover sequences, verification, and post-migration monitoring strategies.

![Zero-downtime deployments: now in open beta](https://developer.upsun.com/images/posts/hands-on/zero-downtime-deployments-with-upsun/ZZD-dev-center.webp)

hands-on

Wednesday, December 3rd 2025

### [Zero-downtime deployments: now in open beta](https://developer.upsun.com/posts/hands-on/zero-downtime-deployments-with-upsun)

We've launched zero-downtime deployments in open beta. Deploy your applications without service interruption.

![AI use-case: Generate load test scenarios with MCPs](https://developer.upsun.com/images/posts/hands-on/ai-use-case-generate-load-test-scenarios/ai-use-case-generate-load-test-scenarios.webp)

hands-on

Thursday, November 27th 2025

### [AI use-case: Generate load test scenarios with MCPs](https://developer.upsun.com/posts/hands-on/ai-use-case-generate-load-test-scenarios)

Automate Locust load testing by combining Chrome MCP and Context7 to generate realistic user behavior patterns with Claude Code.

![Varnish 104: Advanced Traffic Filtering with Classification Headers on Upsun](https://developer.upsun.com/images/posts/hands-on/varnish-104-advanced-traffic-filtering-with-classification-headers-on-upsun/varnish-104.webp)

hands-on

Friday, November 7th 2025

### [Varnish 104: Advanced Traffic Filtering with Classification Headers on Upsun](https://developer.upsun.com/posts/hands-on/varnish-104-advanced-traffic-filtering-with-classification-headers-on-upsun)

Learn how to implement advanced security controls in Varnish on Upsun using classification headers to block malicious traffic, restrict geographic access, filter by ASN, and protect sensitive paths with HTTP Basic Auth.

![Varnish 103: Cache Optimization with URL Normalization on Upsun](https://developer.upsun.com/images/posts/hands-on/varnish-103-cache-optimization-with-url-normalization-on-upsun/varnish-103.webp)

hands-on

Friday, October 31st 2025

### [Varnish 103: Cache Optimization with URL Normalization on Upsun](https://developer.upsun.com/posts/hands-on/varnish-103-cache-optimization-with-url-normalization-on-upsun)

Learn how to maximize Varnish cache efficiency through URL normalization, query string sorting, and tracking parameter removal to dramatically improve cache hit ratios and reduce backend load.

![Varnish 102: Protecting Your Application with Rate Limiting on Upsun](https://developer.upsun.com/images/posts/hands-on/varnish-102-protecting-your-application-with-rate-limiting-on-upsun/varnish-102.webp)

hands-on

Friday, October 24th 2025

### [Varnish 102: Protecting Your Application with Rate Limiting on Upsun](https://developer.upsun.com/posts/hands-on/varnish-102-protecting-your-application-with-rate-limiting-on-upsun)

Learn how to implement effective rate limiting in Varnish using the vsthrottle VMOD to protect your application from abuse, prevent DDoS attacks, and ensure fair resource allocation.

![Varnish 101: Protecting Paths with HTTP Basic Authentication on Upsun](https://developer.upsun.com/images/posts/hands-on/varnish-101-protecting-paths-with-http-basic-authentication-on-upsun/varnish-101.webp)

hands-on

Friday, October 17th 2025

### [Varnish 101: Protecting Paths with HTTP Basic Authentication on Upsun](https://developer.upsun.com/posts/hands-on/varnish-101-protecting-paths-with-http-basic-authentication-on-upsun)

Learn how to implement HTTP Basic Authentication directly in Varnish VCL on Upsun to protect specific paths like admin areas, staging environments, and work-in-progress content without touching your backend.

![Building internal AI agents for our teams on Upsun](https://developer.upsun.com/images/posts/hands-on/building-internal-ai-agents-for-our-teams-on-upsun/building-internal-ai-agents-for-our-teams-on-upsun.webp)

hands-on

Tuesday, September 30th 2025

### [Building internal AI agents for our teams on Upsun](https://developer.upsun.com/posts/hands-on/building-internal-ai-agents-for-our-teams-on-upsun)

Learn how to build and deploy production-ready AI agents on Upsun using Google's ADK, ChromaDB vector database, and Retrieval-Augmented Generation (RAG) to create context-aware, domain-specific agents for your team.

![Run Tailscale on Upsun: Create secure VPN connections for your applications](https://developer.upsun.com/images/posts/hands-on/run-tailscale-on-upsun-secure-vpn-connections/run-tailscale-on-upsun-secure-vpn-connections.webp)

hands-on

Tuesday, September 16th 2025

### [Run Tailscale on Upsun: Create secure VPN connections for your applications](https://developer.upsun.com/posts/hands-on/run-tailscale-on-upsun-secure-vpn-connections)

Learn how to integrate Tailscale VPN with your Upsun applications to create secure, private network connections between your containers and infrastructure.

![Store embeddings in chroma with persistent storage (nodejs and python examples)](https://developer.upsun.com/images/posts/hands-on/store-embeddings-in-chroma-with-persistent-storage-nodejs-and-python-examples/thumbnail.webp)

hands-on

Wednesday, September 3rd 2025

### [Store embeddings in chroma with persistent storage (nodejs and python examples)](https://developer.upsun.com/posts/hands-on/store-embeddings-in-chroma-with-persistent-storage-nodejs-and-python-examples)

Learn how to implement Chroma with persistent storage on Upsun using both Node.js and Python, including document ingestion and embedding storage.

![How to enable custom maintenance page in Fastly](https://developer.upsun.com/images/posts/hands-on/fastly-maintenance/manualjob.webp)

hands-on

Monday, August 25th 2025

### [How to enable custom maintenance page in Fastly](https://developer.upsun.com/posts/hands-on/fastly-maintenance)

Configure GitLab CI/CD to deploy to Upsun from private air-gapped GitLab instances using push-based workflows and API automation.

![Connect multiple projects applications or services together](https://developer.upsun.com/images/posts/hands-on/connect-multiple-projects-applications-or-services-together/connect-multiple-projects-applications-or-services-together.webp)

hands-on

Friday, August 15th 2025

### [Connect multiple projects applications or services together](https://developer.upsun.com/posts/hands-on/connect-multiple-projects-applications-or-services-together)

Learn how to use Chisel to securely connect applications and services across different Upsun projects, with a practical MariaDB replication example.

![Synchronize your air-gapped GitLab with Upsun](https://developer.upsun.com/images/posts/hands-on/gitlab-push-solution/manualjob.webp)

hands-on

Monday, July 21st 2025

### [Synchronize your air-gapped GitLab with Upsun](https://developer.upsun.com/posts/hands-on/gitlab-push-solution)

Configure GitLab CI/CD to deploy to Upsun from private air-gapped GitLab instances using push-based workflows and API automation

![Build and deploy AI-Native Applications with MCP Servers on Upsun](https://developer.upsun.com/images/posts/hands-on/deploy-mcp-servers-on-upsun/deploy-mcp-servers-on-upsun.webp)

hands-on

Thursday, June 5th 2025

### [Build and deploy AI-Native Applications with MCP Servers on Upsun](https://developer.upsun.com/posts/hands-on/deploy-mcp-servers-on-upsun)

Learn how Model Context Protocol servers work with different transports and deploy them to Upsun for scalable AI-powered applications

![NoCode with Upsun: Supercharge Your Automation with Zero Code](https://developer.upsun.com/images/posts/hands-on/nocode-n8n/nocode-n8n-thumbnail.webp)

hands-on

Wednesday, May 14th 2025

### [NoCode with Upsun: Supercharge Your Automation with Zero Code](https://developer.upsun.com/posts/hands-on/nocode-n8n)

Learn how to leverage Upsun to deploy powerful NoCode tools like n8n for workflow automation. Fast setup, secure hosting, and real-world use cases — all without writing code.

![How to run PyTorch in an Upsun application?](https://developer.upsun.com/images/posts/hands-on/pytorch-running-on-upsun/pytorch.webp)

hands-on

Thursday, May 1st 2025

### [How to run PyTorch in an Upsun application?](https://developer.upsun.com/posts/hands-on/pytorch-running-on-upsun)

Learn how to deploy a sentiment analysis application powered by PyTorch and FastAPI on the Upsun cloud platform

![Using PostgreSQL MCP with Upsun Remote Database](https://developer.upsun.com/images/posts/hands-on/postgres-mcp-on-upsun/postgres-mcp-on-upsun.webp)

hands-on

Wednesday, April 30th 2025

### [Using PostgreSQL MCP with Upsun Remote Database](https://developer.upsun.com/posts/hands-on/postgres-mcp-on-upsun)

Learn how to set up an MCP server to connect your Upsun PostgreSQL database to language models like Claude or IDE like VSCode GitHub Copilot and Cursor, enabling natural language data queries without writing SQL.

![How to automatically inject multi-app endpoints as environment variables](https://developer.upsun.com/images/posts/hands-on/route-ids-env/route-ids-env.webp)

hands-on

Monday, April 28th 2025

### [How to automatically inject multi-app endpoints as environment variables](https://developer.upsun.com/posts/hands-on/route-ids-env)

Learn how to use Upsun route identifiers and the PLATFORM\_ROUTES variable to easily get and use the hostnames of dynamically deployed applications in your project.

![Up(sun) and ready with GitHub release assets installation](https://developer.upsun.com/images/posts/hands-on/install-gh-asset-on-upsun/github.webp)

hands-on

Thursday, April 10th 2025

### [Up(sun) and ready with GitHub release assets installation](https://developer.upsun.com/posts/hands-on/install-gh-asset-on-upsun)

Discover how to install any GitHub release asset you want in your Upsun project.

![Experiment with Chainlit AI interface with RAG on Upsun](https://developer.upsun.com/images/posts/hands-on/deploying-chainlit-with-rag/chainlit-thumbnail.webp)

hands-on

Tuesday, January 14th 2025

### [Experiment with Chainlit AI interface with RAG on Upsun](https://developer.upsun.com/posts/hands-on/deploying-chainlit-with-rag)

Learn to deploy production-ready RAG applications with Chainlit and Python on Upsun. Tutorial covers OpenAI Assistants integration, llama\_index implementation, and secure authentication.

![Harnessing the power of Embeddings: a real-world example of a watch recommendation app using a vector database.](https://developer.upsun.com/images/posts/devcenter.webp)

hands-on

Monday, May 20th 2024

### [Harnessing the power of Embeddings: a real-world example of a watch recommendation app using a vector database.](https://developer.upsun.com/posts/hands-on/harnessing-power-embeddings)

Learn how to build a real-world watch recommendation application using embeddings and a vector database. This tutorial covers using Postgres with pgvector, Laravel, React, OpenAI, and Groq, deployed on Upsun.

![Limit deployments to Platform.sh only with tags: part three](https://developer.upsun.com/images/posts/hands-on/guide-to-limit-deployments-to-platformsh-only-with-tags-part-three/Limit_deployments_to_psh-three.webp)

hands-on

Friday, April 12th 2024

### [Limit deployments to Platform.sh only with tags: part three](https://developer.upsun.com/posts/hands-on/guide-to-limit-deployments-to-platformsh-only-with-tags-part-three)

In parts [one](https://developer.upsun.com/posts/hands-on/guide-to-limit-deployments-to-platformsh-only-with-tags-part-one) and

![Limit deployments to Platform.sh only with tags: part one](https://developer.upsun.com/images/posts/hands-on/guide-to-limit-deployments-to-platformsh-only-with-tags-part-one/Limit_deployments_to_psh-one.webp)

hands-on

Thursday, March 14th 2024

### [Limit deployments to Platform.sh only with tags: part one](https://developer.upsun.com/posts/hands-on/guide-to-limit-deployments-to-platformsh-only-with-tags-part-one)

Throughout the years, many users have asked us if it’s possible to only deploy to Platform.sh when a tag is pushed using

![Limit deployments to Platform.sh only when Git tagged: part two](https://developer.upsun.com/images/posts/hands-on/guide-to-limit-deployments-to-platformsh-only-with-tags-part-two/Limit_deployments_to_psh-two.webp)

hands-on

Thursday, March 14th 2024

### [Limit deployments to Platform.sh only when Git tagged: part two](https://developer.upsun.com/posts/hands-on/guide-to-limit-deployments-to-platformsh-only-with-tags-part-two)

In [part one of this series](https://platform.sh/blog/guide-to-limit-deployments-to-platformsh-only-with-tags-part-one/),

![Power-up Your Local Development with DDEV](https://developer.upsun.com/images/posts/hands-on/powerup-your-local-development-with-ddev/Power_ddev_blog.webp)

hands-on

Thursday, January 5th 2023

### [Power-up Your Local Development with DDEV](https://developer.upsun.com/posts/hands-on/powerup-your-local-development-with-ddev)

Get the best local development experience with the DDEV-Platform.sh add-on. Follow our guide, share your feedback, and optimize your workflow


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.