Platform.sh

docs.platform.sh

Our platform as a service (PaaS) gives development teams control and peace of mind while accelerating the time to build and deploy applications.

llms.txt

llms-txt-version: 1.0

Upsun Fixed

Upsun Fixed is a Cloud Application Platform to host all of your web applications.

Things to remember when deploying applications on the Upsun Fixed Cloud Application Platform:

Ultimate developer flexibility: Self-service. Usage-based pricing. Customize your resources, runtimes, users, frontends, backends, APIs. All the choices are yours. Welcome to the Upsun Fixed PaaS.

Application development your way, 4 options to get started sync your GitHub repo with Upsun Fixed, Deploy an existing local Git repository, Kickstart a new repository, Explore Upsun Fixed with our Demo app

Agnostic freedom: Tight integration with external systems, stacks, and tools you already use. Choice of IaaS platform(by geo or cloud provider) and services. Choose the road you want to travel.

Self-service: All the control and customization you want to experiment. Flexible resources. Sensible, transparent, usage-based pricing. Choose self-empowerment.

Composable infrastructure: Dozens of runtimes and backend services to mix and match, Managed routing, with built-in, multiregional edge-caching, automated TLS, and WAF, Full infrastructure preview environments, isolated, but identical to production, Full abstraction from underlying cloud provider; runs precisely the same way on every major cloud

Collaboration-oriented: The ability to collaborate on the infrastructure just like you collaborate on code, Git-driven infrastructure with support for multiple repositories, Bi-directional Git integrations, activity scripts, and webhooks to plug into any external service, Instantly created preview environments—per branch, per PR, per team, per developer, per anything

Scalable on every dimension: Vertical scaling of every component, horizontal scaling of applications and workers, Fully managed, multicloud edge-caching, From a single monolith to an automated service mesh, with microservices, workers' message queues, and multiple data backends, Built-in observability tools, with infrastructure metrics, built-in APM, profiling, and tracing

Stability, security, responsibility: Automated high availability and failover of every infrastructure component, with automated and transparent security-patching, Fine-grained team permissions, with MFA everywhere—even on SSH, Short-lived SSH certificates, with MFA and external identity provider support, PCI DSS, SOC 2, GDPR compliance,

Polyglot? Hyperglot? We glot you: Upsun Fixed supports an array of cool languages and frameworks. Monoliths. Microservices. Multistack. So you can keep your options open. Flexible. And future-proof.

Docs

Get started

Introduction

Deploy

Git init: Initialize your project
Git commit: Start getting your project into Upsun.

Add data

Git branch: Create a separate environment for development and see how it works.
Git merge: Add a service and see how data works between branches.

Monitor and troubleshoot

Git log: See what's happening inside your app.
Git status: Get notified about events so you can react to them.

Learn

What is Upsun Fixed?

Philosophy: Gain insight into the philosophy of Upsun.
YAML: An overview of YAML and its use at Upsun.
What YAML is: An introduction to what YAML is and how to create and modify YAML files.
Upsun Fixed YAML structure: A description of the YAML file for Upsun.
Upsun Fixed YAML tags: A description of custom YAML tags available for Upsun files.
Structure: Learn about how your Upsun environments are structured and which files control that structure.
Build and deploy: See how applications get built and deployed with Upsun.
Get support: Find out how to get help if you're experiencing issues with Upsun.

Tutorials

Automate your code updates: Learn how to automate your dependency updates through a source operation.
Restrict access to a service: Learn how to restrict access to a service using a worker and additional endpoints to the service.
Converting to Upsun Fixed: See how to convert your app to Upsun so it's ready to be deployed.
Exporting data: See how to export your code, files and service data.

Best practices

HTTP caching: See your options for HTTP caching with Upsun.
From monoliths through headless to microservices: Choose the best app topology depending on your needs.
Keep your Git repository clean: To avoid performance issues, prevent your Git repository from becoming too large.

More resources

Frameworks

Django

Deploy Django on Upsun Fixed: See how to get started deploying Django on Upsun.
Configure: Review the basics of what makes up an Upsun project, including its three principle configuration files and how to define them for Django.
Customize: Add some helpful dependencies, and modify your Django site to read from an Upsun environment.
Deploy: Now that your site is ready, push it to Upsun and import your data.
Next steps: With Django deployed, set up your local development environment, compliance requirements, and more.
Local development: Sync Upsun with your local environments to start contributing.
DDEV: Set up an environment with Upsun's recommended local development tool, DDEV.
Tethered local: Connect a locally running Django server directly to active services on an Upsun environment.

Drupal

Deploy Drupal on Upsun Fixed: Create an {{% vendor/company_name %}} account, download a few tools, and prepare to deploy Drupal.
Configure: Review the basics of what makes up an Upsun project, including its three principle configuration files and how to define them for Drupal.
Customize: Add some helpful dependencies, and modify your Drupal site to read from an Upsun environment.
Deploy: Now that your site is ready, push it to Upsun and import your data.
Next steps: Upgrading, adding modules, and further development of your site.
Using Elasticsearch with Drupal: Add an Elasticsearch server to your site and connect it to Drupal.
Using Memcached with Drupal: Configure Memcached instead of Redis for Drupal caching.
Multiple Drupal sites in a single Project: Run multiple applications within the same project, including two or more Drupal sites.
Using Redis with Drupal: Add Redis caching to your existing Drupal site.
Using Valkey with Drupal: Add Valkey caching to your existing Drupal site.
SimpleSAML: Configure third party authentication using SimpleSAML.
Drupal Frequently Asked Questions (FAQ)

Ibexa DXP

Deploy Ibexa DXP on Upsun Fixed: Learn how to use Ibexa DXP on Upsun.
Ibexa DXP with Fastly: Ibexa DXP is a "commercial extended" version of Ibexa OSS that includes, among other things, support for push-based purging on the Fastly CDN.

Symfony

Get started: See how to get started deploying Symfony on Upsun.
Symfony integration: Learn how to use the Symfony integration for a better Upsun experience.
Environment variables: Learn about the environment variables added by the Symfony integration.
Workers: Understand how to configure Symfony workers.
Cron Jobs: Understand how to configure Symfony cron jobs.
Continous Observability with Blackfire: Set up a continuous observability strategy for your Symfony app with Blackfire.
Local development: Sync Upsun with your local environments to start contributing.
FAQ: Troubleshoot issue you might encounter using Symfony, a PHP framework on Upsun.

Laravel

Deploy Laravel on Upsun Fixed: Create an {{% vendor/company_name %}} account, download a few tools, and prepare to deploy Laravel.
Configure: Review the basics of what makes up an Upsun project, including its three principle configuration files and how to define them for Laravel.
Laravel Bridge: Connect your Laravel-based app to Upsun with Laravel Bridge.
Scheduling tasks: Schedule tasks for your Laravel app.
Blackfire: Set up a continuous observability strategy for your Laravel app with Blackfire.
Octane: Improve Laravel apps' performance serving them with Laravel Octane.
Deploy: Now that your Laravel app is ready, push it to Upsun and import your data.
Run a Laravel app on your local machine: Run your Laravel app deployed on Upsun on your local machine.
DDEV: Develop your Laravel app locally with DDEV, a tool for local PHP development environments based on Docker containers.
Lando: Develop your Laravel app locally with Lando, a development tool based on Docker containers.

TYPO3

Deploy TYPO3 on Upsun Fixed: Create an {{% vendor/company_name %}} account, download a few tools, and prepare to deploy TYPO3.
Configure: Review the basics of what makes up an Upsun project, including its three principle configuration files and how to define them for TYPO3.
Customize: Add some helpful dependencies, and modify your TYPO3 site to read from an Upsun environment.
Deploy: Now that your site is ready, push it to Upsun and import your data.
Next steps: Upgrading, adding modules, and further development of your site.

WordPress

Deploy WordPress on Upsun Fixed: Create an {{% vendor/company_name %}} account, download a few tools, and prepare to deploy WordPress using Composer.
Configure: Review the basics of what makes up an Upsun project, including its three principle configuration files and how to define them for WordPress.
Customize: Add some helpful dependencies, and modify your WordPress site to read from an Upsun environment.
Deploy: Now that your site is ready, push it to Upsun and import your data.
Next steps: Upgrading, adding modules, and further development of your site.
Why you should manage WordPress with Composer: This guide will give you a greater understanding for whyUpsun recommends using Composer to manage WordPress.
Upgrade to use Composer: Learn how to use WordPress with Composer on Upsun.
How to Deploy WordPress without Composer on Upsun Fixed: Migrate your existing vanilla WordPress site to Upsun.
Configure: Review the basics of what makes up an Upsun project, including its three principle configuration files and how to define them for WordPress.
Customize: Add some helpful dependencies, and modify your WordPress site to read from an Upsun environment.
Deploy: Now that your site is ready, push it to Upsun and import your data.
Next steps: Upgrading, adding modules, and further development of your site.
Using Redis with WordPress: Configure Redis for your WordPress site.

Pimcore PaaS

Shopware PaaS

Gatsby

Deploy Gatsby on Upsun Fixed: Create an {{% vendor/company_name %}} account, download a few tools, and prepare to deploy Gatsby.
Configure: Review the basics of what makes up an Upsun project, including its three principle configuration files and how to define them for Gatsby.
Deploy: Now that your site is ready, push it to Upsun and import your data.
Next steps: A collection of resources for the further development of your Gatsby site.
Gatsby multi-app projects: You can use Upsun's multi-app configuration to deploy Gatsby alongside a backend CMS, pulling content into Gatsby during builds.
Drupal: Drupal's JSON API module can be used as a data source for Gatsby via gatsby-source-drupal.
Strapi: You can build out an API from scratch with Strapi, and then connect its data to a frontend Gatsby app with gatsby-source-strapi.
WordPress: WordPress's built-in content API can quickly become a content source for Gatsby with gatsby-source-wordpress.

Next.js

Deploy Next.js on Upsun Fixed: Prepare to deploy Next.js.

Strapi

Deploy Strapi on Upsun Fixed: Create an {{% vendor/company_name %}} account, download a few tools, and prepare to deploy Strapi.
Configure: Review the basics of what makes up an Upsun project, including its three principle configuration files and how to define them for Strapi.
Deploy: Now that your site is ready, push it to Upsun and import your data.
Configuring Database Services for Strapi on Upsun Fixed: Configure a preferred database for your Strapi application on Upsun
SQLite: Configure your Strapi application to use a SQLite database on Upsun.
PostgreSQL: Configure your Strapi application to use a PostgreSQL database on Upsun.
MySQL: Configure your Strapi application to use a MySQL database on Upsun.
MongoDB: Configure your strapi application to use a MongoDB database on Upsun (v3 only).
Local development: Running Strapi on your local machine with Upsun Fixed: Run your Strapi application deployed on Upsun on your local machine
Strapi v3: How to develop a Strapi v3 app locally.
Strapi v4: How to develop a Strapi v4 app locally.
Strapi multi-app projects: You can use a multi-app configuration to deploy Strapi alongside a frontend application, pulling content from Strapi into the frontend during builds.
Gatsby: You can build out an API from scratch with Strapi and then connect its data to a frontend Gatsby app with gatsby-source-strapi.

Hibernate

Deploy Hibernate ORM on Upsun Fixed

Jakarta

Deploy Jakarta on Upsun Fixed

Micronaut

Deploy Micronaut on Upsun Fixed: Create an {{% vendor/company_name %}} account, download a few tools, and prepare to deploy Micronaut.
Configure: Review the basics of what makes up an Upsun project, including its three principle configuration files and how to define them for Micronaut.
Customize: Add some helpful dependencies, and modify your Micronaut site to read from an Upsun environment.
Deploy: Now that your site is ready, push it to Upsun and import your data.
Next steps: Resources for further developing your site.
How to Deploy Micronaut on Upsun Fixed with Elasticsearch: Configure a Micronaut application with Elasticsearch.
How to Deploy Micronaut on Upsun Fixed with Micronaut Data: Configure a Micronaut application with Micronaut Data.
How to Deploy Micronaut on Upsun Fixed with MongoDB: Configure a Micronaut application with MongoDB.
How to Deploy Micronaut on Upsun Fixed with Redis: Configure a Micronaut application with Redis.
How to Deploy Micronoaut on Upsun Fixed with JPA: Configure a Micronoaut application with JPA.

Quarkus

Deploy Quarkus on Upsun Fixed: Create an {{% vendor/company_name %}} account, download a few tools, and prepare to deploy Quarkus.
Configure: Review the basics of what makes up an Upsun project, including its three principle configuration files and how to define them for Quarkus.
Customize: Add some helpful dependencies, and modify your Quarkus site to read from an Upsun environment.
Deploy: Now that your site is ready, push it to Upsun and import your data.
Next steps: Resources for further developing your site.
How to Deploy Quarkus on Upsun Fixed with Elasticsearch: Configure a Quarkus application with Elasticsearch.
How to Deploy Quarkus on Upsun Fixed with JPA: Configure a Quarkus application with JPA.
How to Deploy Quarkus on Upsun Fixed with MongoDB: Configure a Quarkus application with MongoDB.
How to Deploy Quarkus on Upsun Fixed with Panache: Configure a Quarkus application with Panache.
How to Deploy Quarkus on Upsun Fixed with Redis: Configure a Quarkus application with Redis.

Spring

Configure Spring with MariaDB/MySQL: Configure a Spring application with MariaDB/MySQL.
Configure Spring with PostgreSQL: Configure a Spring application with PostgreSQL.
Configure Spring with RabbitMQ: Configure a Spring application with RabbitMQ.
Configure Spring with Solr: Configure a Spring application with Solr.
Deploy Spring on Upsun Fixed: Create an {{% vendor/company_name %}} account, download a few tools, and prepare to deploy Spring.
Configure: Review the basics of what makes up an Upsun project, including its three principle configuration files and how to define them for Spring.
Customize: Add some helpful dependencies, and modify your Spring site to read from an Upsun environment.
Deploy: Now that your site is ready, push it to Upsun and import your data.
Next steps: Resources for further developing your site.
How to Deploy Spring on Upsun Fixed with Elasticsearch: Configure a Spring application with Elasticsearch.
How to Deploy Spring on Upsun Fixed with JPA: Configure a Spring application with JPA.
How to Deploy Spring on Upsun Fixed with MongoDB: Configure a Spring application with MongoDB.
How to Deploy Spring on Upsun Fixed with Redis: Configure a Spring application with Redis.

Reference

Configure apps

Choose an image type: Configure your app and control how it's built and deployed on Upsun.
Single-runtime image: See all of the options for controlling your apps and how they're built and deployed on Upsun.
Composable image: Use Upsun's composable image to build and deploy your app.
Image properties: Details about image properties in the Upsun {{< vendor/configfile "app" >}} file
access: An access dictionary that defines the access control for roles accessing app environments.
additional_hosts: An additional hosts dictionary that maps hostnames to IP addresses.
crons: A cron dictionary that defines scheduled tasks for the app.
disk: An integer (or null) that defines the disk space allocated (in MB) to an app.
hooks: A hooks dictionary that defines which commands run at different stages in the build and deploy process.
mounts: Defines the directories that are writable even after the app is built.
relationships: A dictionary of relationships that defines the connections to other services and apps.
size: Defines the amount of resources to dedicate to the app.
source: Contains information about the app’s source code and operations that can be run on it.
variables: A variables dictionary that defines variables to control the environment.
web: A web instance that defines how the web application is served.
workers: Defines the list of worker names, which are alternate copies of the application to run as background processes.
Source operations: Run automated code updates via source operations.
Runtime operations: Set up runtime operations to run one-off commands on your project through the Upsun CLI.
Configure what's served
PHP with front controller: Start with a basic PHP app with a front controller for dynamic requests.
Rewrite requests: Rewrite requests to be served by other parts of your app without directing users.
Serve different paths: Serve directories at different places than where they are in your app.
Static sites: Serve completely static sites
Custom headers: Set custom headers for your static content such as custom content-types or limits to cross-origin usage.
Set up multiple apps in a single project: Create multiple apps within a single project, such as a CMS backend connected to a frontend to display it.
Choose a project structure: Explore possible code structures you can apply to your multiple application projects.
Define routes: Learn about the many ways you can define routes between your apps.
Define relationships: Find out how relationships are managed between your apps.
Timezones: Learn more about the different timezones on Upsun and when you can customize them.
Troubleshoot disks
Troubleshoot mounts
Upgrading
Use build and deploy hooks: Add custom scripts at different stages in the build and deploy process.
Change hooks in different environments: Change what runs in your hooks depending on the current environment type.
Comparison of hooks: What hooks are available in the build and deploy process and how to choose which to use.
Use hooks with dependencies: Manage dependencies for your hooks, such as compiling Sass files as part of your build.
Work with workers: Interact with your worker instances to handle background tasks for your apps.

Add services

Elasticsearch (Search service): Elasticsearch is a distributed RESTful search engine built for the cloud.
Gotenberg: Gotenberg is a user-friendly API for PDF files.
Headless Chrome: Headless Chrome is a headless browser that can be configured on projects like any other service on Upsun.
InfluxDB (Database service): InfluxDB is a time series database optimized for high-write-volume use cases such as logs, sensor data, and real-time analytics.
Kafka (Message queue service): Apache Kafka is an open-source stream-processing software platform.
MariaDB/MySQL (database service): See how to configure a MariaDB/MySQL server to store your data.
MariaDB read-only replication: Configure and access read-only MariaDB replicas to ease the load on a primary database.
External replication: In rare cases, it may be useful to maintain a replica instance of your MySQL/MariaDB database outside of Upsun.
Troubleshoot
Memcached (Object cache): Memcached is a simple in-memory object store well-suited for application level caching.
Mercure
MongoDB (Database service): MongoDB is a cross-platform, document-oriented database.For more information on using MongoDB, see MongoDB's own documentation.
Network Storage
OpenSearch (search service): OpenSearch is a distributed RESTful search engine built for the cloud.
PostgreSQL (Database service)
Read-only replication: Configure and access read-only PostgreSQL replicas to ease the load on a primary database.
RabbitMQ (message queue service): See how to configure RabbitMQ for your messaging needs.
Redis (Object cache)
Valkey
Solr (Search service)
Varnish
Vault key management service

Define routes

Server Side Includes (SSI): SSI commands enable you to include files within other pages.
HTTP cache: Upsun supports HTTP caching at the server level. Caching is enabled by default, but is only applied to GET and HEAD requests.
HTTPS: Learn how to enable HTTPS for your site and configure TLS connections.
Proxy routes: Pass requests to a location outside your Upsun project using proxy routes.
Redirects: Managing redirection rules is a common requirement for web applications, especially in cases where you do not want to lose incoming links that have changed or been removed over time.

Languages

C#/.NET Core: Upsun supports deploying .NET applications by allowing developers to define a build process and pass its variables to the .NET Core build environment.
Elixir: Upsun supports building and deploying applications written in Elixir. There is no default flavor for the build phase, but you can define it explicitly in your build hook. Upsun Elixir images support both committed dependencies and download-on-demand. The underlying Erlang version is 22.0.7.
Go: Upsun supports building and deploying applications written in Go using Go modules. They're compiled during the Build hook phase, and support both committed dependencies and download-on-demand.
Java: Java is a general-purpose programming language, and one of the most popular in the world today. Upsun supports Java runtimes that can be used with build management tools such as Gradle, Maven, and Ant.
Frameworks
Moving to Upsun Fixed
Tuning
JavaScript/Node.js: Get started creating JavaScript apps with Node.js on Upsun.
Debugging
Manage Node.js versions: See how to manage different Node.js versions in your Upsun containers."
PHP: Deploy PHP apps on Upsun.
Extensions: See what PHP extensions are available with each PHP version on Upsun.
Performance tuning
PHP-FPM sizing: Learn how to adjust the maximum number of PHP-FPM workers for your app
FrankenPHP
Xdebug
Custom Redis
Swoole
Authenticated Composer: Allow Composer to authenticate against a private third-party Composer repository and download PHP packages from it.
Troubleshoot: Learn how to troubleshoot common issues in PHP.
Python: Get started creating Python apps on Upsun.
Manage dependencies: See how to manage Python dependencies with different package managers.
Web servers: See how to start your apps as you wish with ASGI and WSGI servers.
Python in non-Python containers: See how to manage different Python versions in your Upsun containers.
Ruby: Upsun supports deploying any Ruby application. Your application can use any Ruby application server such as Puma or Unicorn and deploying a Rails or a Sinatra app is very straight forward.
Rust

Development

Project templates: You can initialize your projects using any of our pre-made template repositories.
Set up your local development environment: Set up a local development environment to test out changes to your app's code.
DDEV: Use DDEV to set up local development environments.
Tethered
Untethered
Docksal
Lando: Find out how to include Lando in your local development workflow.
Variables overview: Variables give you control over your project's build process and runtime environment. You can set them in your code to make changes across your project or independent of the code for environment-specific settings.
Set variables: See how to set variables that you can later use to take control over your app's environment.
Use variables: See how to use variables that have already been set so you can take control over your app's environment.
Access your site: Find the URLs you can use to access your site via a web browser.
Transfer files to and from your app
HTTP Headers: Upsun adds a number of HTTP headers to both inbound and outbound messages. We don't modify or block existing headers on either request or response.
Send email: Send email from your Upsun environments.
Pull code from a private Git repository: See how to pull code from a private Git repository into your Upsun build process.
Use Git submodules
Connect securely with SSH: Keep your project and apps safe by connecting with SSH when you're interacting with your deployed environments or using the Upsun CLI.
SSH keys: See how to authenticate your app connections using SSH keys.
Troubleshoot SSH
Transfer data to and from a Dedicated Gen 2 cluster
Regions: See information about Upsun regions, including their environmental impact and IP addresses.
Troubleshoot development: See some common solutions to issues you might run into in development.
Deploy on Upsun Fixed
Sanitize databases: Remove sensitive information from databases on preview environments to control access.
MariaDB and Drupal: Sanitize MariaDB data in preview environments directly or by using Drush.
PostgreSQL and Django: Sanitize PostgreSQL data in preview environments for Django apps.
PostgreSQL and Symfony: Sanitize PostgreSQL data in preview environments for Symfony apps.

Integrations

External Integrations: Upsun can be integrated with external services.
Activity scripts: Upsun supports custom scripts that can fire in response to any activity. These scripts allow you to take arbitrary actions in response to actions in your project, such as when it deploys, when a new branch is created, etc.
Activity reference: A reference of the properties found in various activities.
Utility routines: The following utility routines can help simplify common tasks in your activity scripts. They're free to copy, modify, bend, fold, spindle, and mutilate as needed for your own scripts. They also demonstrate some common patterns for working with the activity and project data structures.
Example: Discord
Example: Slack
Webhooks: Webhooks allow you to host a script yourself externally that receives the same payload as an activity script and responds to the same events, but can be hosted on your own server in your own language.
Source integrations: See how to maintain your code in a third-party repository that's linked to your Upsun project.
Bitbucket: See how to manage your Upsun environments directly from your Bitbucket repository.
GitHub: See how to manage your Upsun environments directly from your GitHub repository.
GitLab: See how to manage your Upsun environments directly from your GitLab repository.
Resolve access: Learn how to troubleshoot access rights for integrated repositories.
Fastly CDN: The Fastly CDN integration provides a centralized interface within the Upsun Console to oversee your edge traffic, manage cache, edit access control lists (ACLs), and tune performance without switching platforms. You can also manage dynamic configuration by using Edge Dictionaries.
Health notifications: Upsun monitors disk space and inode usage. Learn how health notifications are handled on Grid and Dedicated Gen 2 environments.

Increase observability

Infrastructure metrics: See all of the live infrastructure metrics available to give you an overview of resource usage.
HTTP metrics: Understand HTTP metrics
Dedicated Gen 2 metrics: Understand how to read metrics for {{% names/dedicated-gen-2 %}} environments.
Grid metrics: Understand how to read metrics for Grid environments.
Integrate observability: Find an observability service to optimize your code.
Blackfire: Blackfire is the official Upsun observability service for monitoring and profiling your PHP and Python apps.
New Relic: Upsun supports New Relic application performance monitoring.
Tideways: Upsun supports Tideways APM for PHP. This functionality is only available on PHP 7.0 and later.
Consume logs: See how to access or forward logs to get increased insights into your apps and services.
Access logs: Increase your knowledge of how your apps are performing by accessing their container and activity logs.
Forward Upsun Fixed and Blackfire logs: Send your Upsun and Blackfire logs to a third-party service for further analysis.
Forward Fastly CDN logs: Send your Fastly CDN logs to a third-party service for further analysis.

Manage Upsun Fixed environments

Back up an environment: See how to protect yourself from potential data loss by backing up your environments so they can be restored later.
Restore an environment from a backup: See how to restore an environment from a previous state.
Cancel an activity: See how to cancel running or pending activities in an environment.
Change an environment's parent: Learn how to change.a given environment's parent environment.
Configure HTTP access control: Learn how to control access to.a given environment using HTTP methods.
Deactivate an environment: See how to deactivate environments you aren't using.
Manage search indexing for an environment: Learn how to set up search indexing so only your live production site appears in search results.
Rename the default environment: See how to change the name of your default/production environment after creating a project.
Scale your live site: Learn how to scale your live site.

Manage projects

Change a project's region: See how to change the region your project is in and why you might want to do so.
Change the project timezone: See how to change the timezone for a project and what it affects.
Delete a project: See how to delete projects you no longer need.

Custom domains

Set up a custom domain: Add a custom domain to your project once it's ready to go live.
DNS and apex domains: See why CNAME records are used and how to handle apex domains.
Custom TLS certificates
Handle subdomains: How to handle multiple subdomains in different projects.
Preview environments: Learn how to set up custom domains on your preview environments
Content delivery networks (CDNs): Improve performance for distributed end-users of your website with a content delivery network (CDN).
Fastly setup: Learn how to configure your Fastly CDN.
Managed Fastly CDN: Bring your content closer to users with a Fastly CDN fully managed by Upsun.
Cloudflare setup: Learn how to configure your Cloudflare CDN.
Going Live - Troubleshooting: If your site doesn't resolve after you've made DNS changes, check potential solutions to common issues.

Administration

Command line interface (CLI): See how to use and manage your Upsun projects directly from your terminal. Anything you can do within the Console can be done with the CLI.
API tokens
Command reference
Console: Upsun provides a web console so you can interact with your projects and manage your environments.
Configure a project: Configure settings that apply across a project, such as the name, access, and domain.
Configure environments: Configure your environments including their name, status, and visibility.
Organizations: See how to manage multiple Upsun projects at once through organizations.
Administer teams: Manage team access and permissions across all your projects and organizations.
Administer users: Manage user access and permissions across all your projects and organizations.
Pricing: See the basics of the plans Upsun offers and how to adjust them.
Payment FAQ: Learn about billing cycles, supported payment methods, accepted currencies, and fraud protection on Upsun.
Server upgrades: Information about how Upsun upgrades servers
Security: For enhanced security, enable Multifactor Authentication (MFA) or Single Sign-On (SSO).
Multifactor Authentication (MFA): Enhance your organizations' security with Multifactor Authentication (MFA).
Single Sign-On (SSO): Upsun enables you to set up mandatory SSO with a third-party identity provider (IdP) for all your users.

Security and compliance

Backup and restore: See backup policies and the recovery point objective (RPO) and recovery time objective (RTO) for various schedules.
Data retention: Upsun logs and stores various types of data as a normal part of its business. This information is only retained as needed to perform relevant business functions. Retention periods vary depending on the type of data stored. If a legal obligation, law enforcement request, or ongoing business need so requires, data may be retained after the original purpose for which it was collected ceases to exist.
Project isolation: Learn how project isolation is handled at Upsun
Web Application Firewall (WAF): Find out which WAF options Upsun offers to help protect your site.
Upsun Fixed WAF: Learn how the WAF can help protect your site from distributed denial of service (DDoS) attacks.
Fastly Next-Gen WAF: Find out about the offers you can choose from to subscribe to the Fastly Next-Gen Web Application Firewall (WAF) through Upsun.

Dedicated environments

Overview: Our Dedicated Environments are well-suited for those who need more resources and redundancy, along with stricter isolation requirements.
Dedicated Gen 2: {{% names/dedicated-gen-2 %}} is a robust, redundant layer. This section contains all resources concerning the {{% names/dedicated-gen-2 %}} product.
DG2 overview: Dedicated Generation 2 is a robust, redundant layer. It’s well-suited for those who like the Upsun Fixed development experience but need more resources and redundancy for their production environment.
DG2 development: Learn about the cluster infrastructure of Dedicated Generation 2, and discover key details about split architecture, deployment, storage limits and memory.
Environment differences: See the differences between your Production/Staging environments and your development environments (which are Grid environments).
Security and monitoring: Learn how project isolation, encryption, and performance monitoring ensure the security of your Dedicated Gen 2 projects.
Dedicated backup and restores: Backups are retained for different periods depending on various factors. These processes can be either manual or automated.