Back to templates
Overleaf icon

Deploy Overleaf on Sealos

Overleaf is an open-source online real-time collaborative LaTeX editor.

Tools
Deploy Overleaf in a few clicks from the Sealos App Store.Run a self-hosted open-source service on Kubernetes-backed infrastructure.Get automatic HTTPS, routing, and resource management from Sealos.Avoid manual YAML while keeping control of the deployed workload.

Why deploy on Sealos

Sealos makes deploying any app effortless, secure, and production-ready. From one-click launch to ongoing operations, we handle the heavy lifting so you can focus on what matters.

One-Click Deploy
Sealos logo
Compute
Networking
Storage
Security
Observability
Your Application is Live

One-Click Deployment

Deploy any app template in seconds. No compose setup, manual configure, and go live.

Managed Kubernetes Reliability

Built on Sealos Managed Kubernetes for high availability, auto-scaling, and self-healing by default.

Automatic HTTPS & Security

Every deployment includes a secure domain with automatic SSL. We handle certificates and text protection for you.

Persistent Storage

Attach persistent volumes with ease. Your data stays safe, durable, and always accessible.

Scale when needed

Adjust resources as your app grows, no downtime required.

You Get the Whole Stack

Sealos provisions and connects every resource your application needs. Everything is ready to use.

One-click, fully provisionedSecure by defaultProduction ready

App Service

Your application is running and ready to serve requests.

Public HTTPS URL

Secure, global endpoint to access your application.

Database

Managed database instance for your application.

Persistent Volume

Durable storage for uploads and application data.

Environment Variables

Configuration and secrets injected securely into your app.

Logs & Metrics

Centralized logs and basic metrics are enabled.

README

README.md

Deploy and Host Overleaf on Sealos

Overleaf is an open-source, real-time collaborative LaTeX editor. This template deploys Overleaf Community Edition 6.2.0 with KubeBlocks MongoDB, KubeBlocks Redis, persistent project storage, and an HTTPS public endpoint on Sealos Cloud.

About Hosting Overleaf

Overleaf provides a browser-based LaTeX workspace for writing papers, technical reports, books, and teaching materials. It combines source editing, project management, and PDF compilation in one web application, so teams can collaborate without installing a local TeX environment.

This Sealos template provisions the Overleaf web application, MongoDB for application metadata, Redis for realtime/session coordination, and persistent storage at /var/lib/overleaf for user data. Sealos manages the Kubernetes resources, public ingress, TLS certificate, and the App launch entry.

Common Use Cases

  • Academic writing: Write and compile LaTeX papers, theses, and reports in a browser.
  • Team collaboration: Let trusted users edit shared LaTeX projects in one workspace.
  • Teaching environments: Provide students with a ready-to-use LaTeX editor without local setup.
  • Technical documentation: Maintain structured LaTeX documents with persistent project storage.

Dependencies for Overleaf Hosting

The Sealos template includes all required runtime dependencies: Overleaf Community Edition, KubeBlocks MongoDB, KubeBlocks Redis, persistent storage, Service, Ingress, and Sealos App metadata.

Deployment Dependencies

Implementation Details

Architecture Components:

  • Overleaf web service: Runs sharelatex/sharelatex:6.2.0 and exposes the web UI on port 80.
  • MongoDB: Stores users, projects, and Overleaf application metadata through KubeBlocks MongoDB 8.0.4.
  • Redis: Provides Overleaf cache/realtime coordination through KubeBlocks Redis 7.2.7.
  • Persistent project storage: Stores Overleaf data under /var/lib/overleaf on a 1 GiB volume.
  • Optional Sealos Object Storage: When enable_external_files is enabled, four private S3-compatible buckets store user files, templates, project history blobs, and history chunks.
  • Ingress and App entry: Publishes the HTTPS URL and integrates the deployment into the Sealos App launcher.

Configuration:

The template sets OVERLEAF_SITE_URL from the generated Sealos hostname, enables proxy-aware behavior, and keeps email confirmation disabled by default for first-run Community Edition setup. enable_external_files selects the optional Sealos S3-compatible backend for project files and history; the default uses the mounted /var/lib/overleaf volume. Overleaf Community Edition is intended for trusted users; isolated/sandboxed compiles are a Server Pro feature, not part of this template.

License Information:

This Sealos template is provided under the repository license. Overleaf Community Edition is distributed by the Overleaf project; review the upstream repository for application licensing details.

Why Deploy Overleaf on Sealos?

Sealos is an AI-assisted Cloud Operating System built on Kubernetes that unifies the application lifecycle from deployment to operation. By deploying Overleaf on Sealos, you get:

  • One-Click Deployment: Create the Overleaf app, databases, storage, ingress, and App launcher entry from one template.
  • Managed Dependencies: Use KubeBlocks MongoDB and Redis without hand-writing Kubernetes manifests.
  • Persistent Storage Included: Keep Overleaf project data across restarts through the mounted data volume.
  • Instant Public Access: Get an HTTPS URL managed by Sealos Ingress and certificates.
  • Easy Resource Tuning: Adjust CPU, memory, and storage from Sealos resource cards as usage grows.
  • Zero Kubernetes Expertise Required: Operate Overleaf from the Sealos UI while retaining Kubernetes-backed reliability.

Deployment Guide

  1. Open the Overleaf template and click Deploy Now.
  2. Configure the parameters in the popup dialog. The defaults are enough for a first test deployment; enable Enable External Files when project files and history should use Sealos S3-compatible storage.
  3. Wait for deployment to complete. The first cold start can take several minutes because Overleaf initializes MongoDB indexes and runs migrations.
  4. Open the generated Overleaf URL from the Sealos App entry. The ingress redirects the root path / to /launchpad.
  5. On /launchpad, enter an email address and password, then click Register to create the first administrator account.
  6. Sign in from /login, then open /project to start using Overleaf. Administrators can create additional users from /admin/register.

Configuration

Deployment parameters:

NameDescriptionDefault
OVERLEAF_SITE_LANGUAGESet the Overleaf interface language.zh-CN
OVERLEAF_APP_NAMESet the displayed Overleaf site name.Overleaf Community Edition
ENABLED_LINKED_FILE_TYPESComma-separated linked file types enabled for projects.project_file,project_output_file
ENABLE_CONVERSIONSEnable thumbnail generation with ImageMagick.true
EMAIL_CONFIRMATION_DISABLEDDisable email confirmation for first-run local account setup.true
enable_external_filesProvision four private Sealos S3-compatible buckets for project files and history.false

After deployment, open the root URL to continue to /launchpad and create the first administrator account. Sign in from /login after setup. Administrators can create additional users from /admin/register, while /register remains the Community Edition administrator-contact page.

With enable_external_files=true, the template injects the documented OVERLEAF_FILESTORE_* and OVERLEAF_HISTORY_* S3 variables, including path-style access for the Sealos endpoint. The four buckets are private and retain the MongoDB and Redis topology required by Overleaf.

Scaling

The template is tuned for a small Community Edition deployment. The default app allocation is 1 vCPU and 2 GiB memory for the Overleaf container, plus KubeBlocks MongoDB and Redis at 500 mCPU and 512 MiB memory per database component. Increase memory first if cold starts, migrations, or PDF compilation workloads become slow.

To scale resources, open the deployment Canvas, click the relevant resource card, adjust CPU, memory, storage, or replicas, and apply the change in the dialog.

Troubleshooting

First start takes several minutes

Overleaf runs database migrations on an empty MongoDB database. Wait until the Overleaf pod is Ready before opening the site.

/register says “Please contact to create an account”

This is the expected Community Edition account policy. Use /launchpad to create the first administrator, then sign in from /login. Administrators can create additional users from /admin/register.

/launchpad reports that setup is complete

The first administrator account already exists. Sign in from /login, then use /admin/register to create additional users.

Login succeeds but projects are slow to open

Check the Overleaf pod memory and database health in Sealos. Increase the Overleaf memory limit if the instance is used for larger documents or heavier compilation workloads.

S3-backed project files are unavailable

Check that all four ObjectStorageBucket resources are Ready, their generated Secrets exist, and the Overleaf pod restarted after enabling enable_external_files. Review the pod logs for endpoint, credentials, or bucket permission errors.

Getting Help

Additional Resources

License

This Sealos template is provided under the templates repository license. Overleaf Community Edition is licensed by the Overleaf project; review the upstream repository for current application license terms.

Related templates

Explore more production-ready templates.

More