# Platform Sh

> Changes to your environments, such as deployments, cron jobs, and code or variable updates,

## Pages

- [Access your logs](access-logs.md): Changes to your environments, such as deployments, cron jobs, and code or variable updates,
- [Access your site](access-site.md): Once you have an environment running, you can view it in a web browser.
- [access](access.md): An access dictionary that defines the access control for roles accessing app environments.
- [Activity scripts](activity.md): Upsun supports custom scripts that can fire in response to any activity. These scripts allow you to take arbitrary ac...
- [Add services](add-services.md): Upsun includes many services, so you don't have to subscribe to external cache or search engine services.
- [additional_hosts](additional-hosts.md): An additional hosts dictionary that maps hostnames to IP addresses.
- [Administration](administration.md)
- [Authenticate the CLI using an API token](api-tokens.md): You need to set up an API token to authenticate the Upsun CLI for any of the following tasks:
- [Choose an image type](app-reference.md): An _image_ represents the configuration of the container that contains the application (or service) that you want to ...
- [Back up an environment](backup.md): When you're making changes to your apps,
- [Best practices](bestpractices.md)
- [Integrate with Bitbucket](bitbucket.md): If you have code in a Bitbucket repository, you might want to connect it to a Upsun project.
- [Build and deploy](build-deploy.md): Each time you push a change to your app through Git or activate an [environment](https://docs.upsun.com/environments....
- [HTTP cache](cache.md): Upsun supports HTTP caching at the server level. Caching is enabled by default, but is only applied to``GET``and``...
- [Cancel an activity](cancel-activity.md): If you have a stuck activity or you pushed a change you know doesn't work,
- [Content delivery networks (CDNs)](cdn.md): Using a CDN speeds up the delivery of your site's content to its users.
- [Change an environment's parent](change-parent.md): All environments default to having another environment as their parent.
- [Change the project timezone](change-project-timezone.md): The project timezone affects [automated backups](https://docs.upsun.com../environments/backup.md).
- [Keep your Git repository clean](clean-repository.md): When a Git repository contains a high number of references and files, the performance of Git can decrease.
- [Command line interface (CLI)](cli.md): See how to use and manage your Upsun projects directly from your terminal. Anything you can do within the Console can...
- [Set up your Cloudflare CDN](cloudflare.md): You can [use a CDN](https://docs.upsun.com/domains/cdn.md) to deliver your site's content to users more quickly.
- [Composable image](composable-image.md): The Upsun composable image provides enhanced flexibility when defining your app.
- [Authenticated Composer repositories](composer-auth.md): p:last-child]:mb-0 [&>h3]:mt-0 rounded-lg" >
- [Configure environments](configure-environment.md): From your project's main page in the Console, you can see all your environments as a list or a project tree:
- [Configure a project](configure-project.md): Each project has settings that apply to everything within that project, including all its environments.
- [Configure apps](create-apps.md): Control your apps and how they’re built and deployed on Upsun with YAML configuration.
- [crons](crons.md): A cron dictionary that defines scheduled tasks for the app.
- [Set up a custom domain on a preview environment](custom-domains-preview-environments.md): [Preview environments](https://docs.upsun.com/glossary.md#preview-environment) in your project can't use the custom d...
- [Set custom headers on static content](custom-headers.md): When your app responds to dynamic requests, it can generate headers on the fly.
- [Data retention](data-retention.md): Upsun logs and stores various types of data as a normal part of its business. This information is only retained as ne...
- [Use DDEV for local development](ddev.md): [DDEV](https://ddev.readthedocs.io/en/stable/) is an open-source tool for local development environments.
- [Deactivate an environment](deactivate-environment.md): If you have environments you aren't using, you may want to deactivate them to save resources for what you need.
- [Debugging](debug.md): p:last-child]:mb-0 [&>h3]:mt-0 rounded-lg" >
- [Rename the default environment](default-environment.md): You can set the name of your default/production environment when creating a project.
- [Define routes](define-routes.md): A [_route_](https://docs.upsun.com/glossary.md#route) defines how requests are handled _after_ they reach Upsun. It t...
- [Delete a project](delete-project.md): To delete a project, you must be an organization owner or have the [manage plans permission](https://docs.upsun.com.....
- [Manage Python dependencies](dependencies.md): p:last-child]:mb-0 [&>h3]:mt-0 rounded-lg" >
- [Automate your code updates](dependency-updates.md): Upsun allows you to update your dependencies through [source operations](https://docs.upsun.com/create-apps/source-op...
- [Development](development.md)
- [Example: Discord](discord.md): The following example activity script posts a message to a Discord channel every time it's triggered.
- [DNS management and apex domains](dns.md): Using`CNAME`records helps prevent downtime during maintenance operations.
- [Custom domains](domains.md)
- [C#/.NET Core](dotnet.md): p:last-child]:mb-0 [&>h3]:mt-0 rounded-lg" >
- [Edgee (Edge Analytics)](edgee.md): Edge Analytics enables enterprises to collect analytics data at the edge, rather than in the browser. This approach h...
- [Elasticsearch (Search service)](elasticsearch.md): Elasticsearch is a distributed RESTful search engine built for the cloud.
- [Elixir](elixir.md): p:last-child]:mb-0 [&>h3]:mt-0 rounded-lg" >
- [Send email](email.md): You can configure your Upsun environments to send emails via an SMTP proxy.
- [Manage Upsun Fixed environments](environments.md): An Upsun environment contains one instance of an app (or [group of apps](https://docs.upsun.com../create-apps/multi-a...
- [Exporting data](exporting.md): As an Upsun user, your code and data belong to you.
- [Extensions](extensions.md): **Note**:
- [Fastly CDN](fastly-cdn.md): The Fastly CDN integration provides a centralized interface within the Upsun Console to oversee your edge traffic, ma...
- [Set up your Fastly CDN](fastly.md): You can [use a CDN](https://docs.upsun.com/domains/cdn.md) to deliver your site's content to users more quickly.
- [Transfer files to and from your app](file-transfer.md): After your app is built, its file system is read-only.
- [firewall](firewall.md): A firewall dictionary that defines the outbound firewall rules for the application.
- [Forward Upsun Fixed and Blackfire logs](forward-logs.md): You might use a service to analyze logs from various parts of your fleet.
- [PHP-FPM sizing](fpm.md): p:last-child]:mb-0 [&>h3]:mt-0 rounded-lg" >
- [FrankenPHP](frankenphp.md): [FrankenPHP](https://frankenphp.dev/) is a modern PHP application server designed as a high-performance alternative t...
- [Get support](get-support.md): Find out how to get help if you’re experiencing issues with Upsun.
- [Integrate with GitHub](github.md): If you have code in a GitHub repository, you might want to connect it to a Upsun project.
- [Integrate with GitLab](gitlab.md): If you have code in a GitLab repository, you might want to connect it to a Upsun project.
- [Glossary](glossary.md): An environment that's deployed.
- [Go](go.md): p:last-child]:mb-0 [&>h3]:mt-0 rounded-lg" >
- [Gotenberg](gotenberg.md): Gotenberg is a stateless API for converting various document formats into PDF files.
- [HTTP Headers](headers.md): Upsun adds a number of HTTP headers to both inbound and outbound messages. We don’t modify or block existing headers ...
- [Headless Chrome](headless-chrome.md): Headless Chrome is a headless browser that can be configured on projects like any other service on Upsun.
- [Use hooks with dependencies](hooks-and-dependencies.md): If you use a specific package in a hook, you may want to manage dependencies for it.
- [Comparison of hooks](hooks-comparison.md): The following table presents the main differences among the three available hooks:
- [hooks](hooks.md): A hooks dictionary that defines which commands run at different stages in the build and deploy process.
- [Configure HTTP access control](http-access-control.md): When developing your site, you might want to hide your preview environments from outside viewers.
- [HTTP caching](http-caching.md): You can configure HTTP caching for your site on Upsun in several ways.
- [HTTP metrics](http-metrics.md): The HTTP metrics dashboard provides Upsun users with network-related metrics.
- [HTTPS](https.md): Using HTTPS for your site helps ensure your users' information remains secure.
- [Image properties](image-properties.md): **Note:** The properties below are available in **both** [single-runtime image](https://docs.upsun.com/create-apps/ap...
- [Increase observability](increase-observability.md): Observability refers to the capability to evaluate the current state of an application and its architecture by analyz...
- [InfluxDB (Database service)](influxdb.md): InfluxDB is a time series database optimized for high-write-volume use cases such as logs, sensor data, and real-time...
- [Integrations](integrations.md)
- [Java](java.md): p:last-child]:mb-0 [&>h3]:mt-0 rounded-lg" >
- [Kafka (Message queue service)](kafka.md): Apache Kafka is an open-source stream-processing software platform.
- [Languages](languages.md)
- [Set up your local development environment](local.md): To make changes to your app's code and test them without affecting your production environment,
- [Consume logs](logs.md)
- [Managed Fastly CDN](managed-fastly.md): Instead of starting your own Fastly subscription and [managing your CDN yourself](https://docs.upsun.com/domains/cdn/...
- [Sanitizing databases: MariaDB and Drupal](mariadb.md): Databases of live websites often contain personally identifiable information (PII)
- [Memcached (Object cache)](memcached.md): Memcached is a simple in-memory object store well-suited for application level caching.
- [Mercure](mercure.md): [Mercure](https://mercure.rocks/) is a real-time communication protocol and hub designed for modern web apps. It allo...
- [Infrastructure metrics](metrics.md): Upsun projects are accompanied by live infrastructure metrics that provide an overview of resource usage for environm...
- [Multifactor Authentication (MFA)](mfa.md): **Feature Availability**
- [Convert to Upsun Fixed](migrating.md): Learn how you can convert your site from another hosting solution to Upsun.
- [Moving a Java application to Upsun Fixed](migration.md): p:last-child]:mb-0 [&>h3]:mt-0 rounded-lg" >
- [MongoDB (Database service)](mongodb.md): MongoDB is a cross-platform, document-oriented database.For more information on using MongoDB, see [MongoDB’s own doc...
- [mounts](mounts.md): Directories that are writable even after the app is built. Allocated disk for mounts is defined with a separate resou...
- [Set up multiple apps in a single project](multi-app.md): You can create multiple apps within a single project so they can share data.
- [MariaDB read-only replication](mysql-readonly-replication.md): You can improve the performance of read-heavy applications by defining read-only replicas of your MariaDB database an...
- [MariaDB/MySQL external replication](mysql-replication.md): In rare cases, it may be useful to maintain a replica instance of your MySQL/MariaDB database outside of Upsun on a r...
- [MariaDB/MySQL (database service)](mysql.md): Upsun supports both MariaDB and Oracle MySQL to manage your relational databases.
- [Network Storage](network-storage.md): The Network Storage service enables a new kind of [mount](https://docs.upsun.com../create-apps/image-properties/mount...
- [Manage Node.js versions](node-version.md): p:last-child]:mb-0 [&>h3]:mt-0 rounded-lg" >
- [JavaScript/Node.js](nodejs.md): p:last-child]:mb-0 [&>h3]:mt-0 rounded-lg" >
- [Health notifications](notifications.md): Upsun can notify you when various events happen on your project, in any environment. At this time the only notificati...
- [From monoliths through headless to microservices](oneormany.md): With Upsun, you can run multiple application containers in a single environment.
- [OpenSearch (search service)](opensearch.md): OpenSearch is a distributed RESTful search engine built for the cloud.
- [Organizations](organizations.md): Organizations allow you to manage your Upsun projects, users, and billing.
- [What is Upsun Fixed?](overview.md): Upsun is a Cloud Application Platform built especially for continuous deployment.
- [Philosophy](philosophy.md): Upsun aims at reducing configuration and making developers more productive.
- [Create a basic PHP app with a front controller](php-basic.md): To handle dynamic requests to your PHP app, you might want to use a [front controller](https://en.wikipedia.org/wiki/...
- [PHP](php.md): **Note**:
- [Upsun Fixed YAML tags](platform-yaml-tags.md): In addition to the [basic functions you should be familiar with](https://docs.upsun.com/learn/overview/yaml/what-is-y...
- [PostgreSQL read-only replication](postgresql-readonly-replication.md): You can improve the performance of read-heavy applications by defining read-only replicas of your PostgreSQL database...
- [Sanitizing databases: PostgreSQL and Symfony](postgresql-symfony.md): Databases of live websites often contain personally identifiable information (PII)
- [PostgreSQL (Database service)](postgresql.md): PostgreSQL is a high-performance, standards-compliant relational SQL database.
- [Pricing](pricing.md): Upsun offers flexible, predictable [pricing](https://upsun.com/pricing/) for organizations and projects.
- [Pull code from a private Git repository](private-repository.md): To complete its build, your Upsun project may need to access pieces of code stored in private Git repositories.
- [Project isolation](project-isolation.md): At Upsun, customer environments are strictly isolated from each other using [namespaces](https://man7.org/linux/man-p...
- [Choose a project structure](project-structure.md): How you structure a project with multiple apps depends on how your code is organized
- [Manage projects](projects.md): See how to manage projects within Upsun.
- [Proxy routes](proxy.md): **Warning**:
- [Manage Python versions in non-Python containers](python-version.md): p:last-child]:mb-0 [&>h3]:mt-0 rounded-lg" >
- [Python](python.md): p:last-child]:mb-0 [&>h3]:mt-0 rounded-lg" >
- [RabbitMQ (message queue service)](rabbitmq.md): [RabbitMQ](https://www.rabbitmq.com/documentation.md) is a message broker
- [Redirects](redirects.md): Managing redirection rules is a common requirement for web applications, especially in cases where you do not want to...
- [Redis (Object cache)](redis.md): [Redis](https://redis.io/documentation) is a multi-model database that allows you to store data in memory
- [Activity reference](reference.md): Activities log changes to your project,
- [Change a project's region](region-migration.md): To host your project data, Upsun offers several [regions](https://docs.upsun.com../development/regions.md).
- [Regions](regions.md): Upsun offers several regions for hosting project data.
- [relationships](relationships.md): A dictionary of relationships that defines the connections to other services and apps.
- [Request features](request-features.md): We’re always open to new and fresh ideas that can help improve our product. Learn how to make a feature request and e...
- [Restore an environment from a backup](restore.md): Once you have [backups of your environment](https://docs.upsun.com/environments/backup.md), you can restore data from...
- [Restrict access to a service](restrict-service-access.md): Upsun allows you to restrict access to a service.
- [Rewrite requests without redirects](rewrite-requests.md): You might want to rewrite requests so they're served by specific sections of your app
- [Define routes for your multiple apps](routes.md): When you set up a project containing multiple applications,
- [Ruby](ruby.md): p:last-child]:mb-0 [&>h3]:mt-0 rounded-lg" >
- [Runtime operations](runtime-operations.md): Runtime operations allow you to trigger one-off commands or scripts on your project.
- [Rust](rust.md): p:last-child]:mb-0 [&>h3]:mt-0 rounded-lg" >
- [Sanitize databases](sanitize-db.md): When working on a new feature on your website, you want to use a new branch.
- [Set an environment's visibility to search engines](search-engine-visibility.md): When you have preview environments,
- [Security](security.md)
- [Serve directories at different paths](serve-different-directories.md): In some cases you might want to depart from the common practice of serving directories directly.
- [Web servers](server.md): p:last-child]:mb-0 [&>h3]:mt-0 rounded-lg" >
- [Server upgrades](servers.md): To ensure your projects get the latest features, improvements, and bug fixes, Upsun updates the servers that deliver ...
- [Set variables](set-variables.md): To set variables, determine which [type of variable](https://docs.upsun.com/development/variables.md#variable-types) ...
- [Single-runtime image](single-runtime-image.md): See all of the options for controlling your apps and how they’re built and deployed on Upsun.
- [Example: Slack](slack.md): The following example activity script posts a message to a Slack channel every time it's triggered.
- [Solr (Search service)](solr.md): Apache Solr is a scalable and fault-tolerant search index.
- [Source operations](source-operations.md): On Upsun, you can run automated code updates through a feature called **source operations**.
- [source](source.md): Contains information about the app’s source code and operations that can be run on it.
- [Authenticate with SSH keys](ssh-keys.md): To connect to your app using SSH keys, you need two keys:
- [Connect securely with SSH](ssh.md): When you interact with a deployed environment, you need to guard your connection against unauthorized access.
- [Server Side Includes (SSI)](ssi.md): SSI commands enable you to include files within other pages.
- [Single Sign-On (SSO)](sso.md): **Feature Availability**
- [Serve static sites](static.md): Static site generators are a popular way to create fast sites.
- [Set up a custom domain](steps.md): Once your project is ready for production, replace the automatically generated domain with your own custom domain.
- [Structure](structure.md): Each environment you deploy on Upsun is built as a set of containers.
- [Handle subdomains across different projects](subdomains.md): You can host multiple subdomains, such as`foo.example.com`and`bar.example.com`,
- [Use Git submodules](submodules.md): Upsun allows you to use submodules in your Git repository.
- [Swoole](swoole.md): p:last-child]:mb-0 [&>h3]:mt-0 rounded-lg" >
- [Administer teams](teams.md): **Feature Availability**
- [Tethered local development](tethered.md): To test changes locally, you can connect your locally running web server
- [Timezones](timezone.md): On Upsun, there are several timezones you might want to keep in mind.
- [Configure a third-party TLS certificate](tls.md): Upsun automatically provides standard Transport Layer Security (TLS) certificates for all sites and environments.
- [Troubleshoot disks](troubleshoot-disks.md): For more general information, see how to [troubleshoot development](https://docs.upsun.com/development/troubleshoot.md).
- [Troubleshoot mounts](troubleshoot-mounts.md): For more general information, see how to [troubleshoot development](https://docs.upsun.com/development/troubleshoot.md).
- [Troubleshoot SSH](troubleshoot-ssh.md): While trying to use SSH, you may get a response indicating permission is denied. Or if you get an error with a code o...
- [Troubleshoot MySQL](troubleshoot.md): For more general information, see how to [troubleshoot development](https://docs.upsun.com/development/troubleshoot.md).
- [Performance tuning Java](tuning.md): p:last-child]:mb-0 [&>h3]:mt-0 rounded-lg" >
- [Tutorials](tutorials.md)
- [Untethered local development](untethered.md): It's possible to run your entire site locally on your computer.
- [Use variables](use-variables.md): Get a list of all variables defined on a given environment in [the Console](https://docs.upsun.com../../administratio...
- [Administer users](users.md): Upsun offers fine-grained and flexible user permissions across projects and organizations.
- [Utility routines](utility.md): The following utility routines can help simplify common tasks in your activity scripts. They’re free to copy, modify,...
- [Valkey](valkey.md): [Valkey](https://valkey.io/) is an open source datastore that can be used high-performance data retrieval and key-val...
- [variables](variables.md): A variables dictionary that defines variables to control the environment.
- [Varnish](varnish.md): Varnish is a popular HTTP proxy server, often used for caching.
- [Change hooks in different environments](vary-hooks-by-environment.md): You might have certain commands you want to run only in certain environments.
- [Vault key management service](vault.md): The Vault key management service (KMS) provides key management and access control for your secrets.
- [web](web.md): A web instance that defines how the web application is served.
- [Webhooks](webhooks.md): Webhooks allow you to host a script yourself externally that receives the same payload as an activity script and resp...
- [What YAML is](what-is-yaml.md): [YAML](https://en.wikipedia.org/wiki/YAML) is a human-readable format for data serialization.
- [workers](workers.md): Defines the list of worker names, which are alternate copies of the application to run as background processes.
- [Using Xdebug](xdebug.md): p:last-child]:mb-0 [&>h3]:mt-0 rounded-lg" >
- [Upsun Fixed YAML structure](yaml-structure.md): In addition to the [basic functions you should be familiar with](https://docs.upsun.com/learn/overview/yaml/what-is-y...
- [YAML](yaml.md): [YAML](https://en.wikipedia.org/wiki/YAML) is a human-readable format for data serialization across languages.