Timezones

On Upsun, there are several timezones you might want to keep in mind. All timezones default to UTC time. You can customize some of them, but in most cases, it’s best if you leave them in UTC and store user data with an associated timezone instead. The different timezones on Upsun are the following:

Timezone	Description	Customizable
Container timezone	The timezone for all Upsun containers (UTC).	No
App runtime timezone	Set an app runtime timezone if you want your app runtime to use a specific timezone instead of the container timezone. The app runtime timezone only affects your app itself.	Yes
Cron timezone	Set a cron timezone if you want your crons to run in a specific timezone instead of the app runtime timezone (or instead of the container timezone if no app runtime timezone is set on your project). The cron timezone only affects your cron jobs.	Yes
Log timezone	The timezone for all Upsun logs (UTC).	No

Each Upsun project also has a project timezone that only affects automated backups. By default, the project timezone is based on the region where your project is hosted. You can change it from the Console at any time.

Set an app runtime timezone

How you can set an app runtime timezone depends on your actual app runtime:

PHP
Node.js
Python
Java

Add the following to your app configuration:

.upsun/config.yaml

applications:
  # The name of the app container. Must be unique within a project.
  myapp:
    # The location of the application's code.
    variables:
      php:
        "date.timezone": "Europe/Paris"

Start the server with env TZ='<TIMEZONE>' node server.js.

Start the server with env TZ='<TIMEZONE>' python server.py.

Start the server with env TZ='<TIMEZONE>' java -jar ... OR set the Java virtual machine argument user.timezone. This Java virtual machine argument takes precedence over the environment variable TZ. For example, you can use the flag -D when running the application: java -jar -D user.timezone=GMT or java -jar -D user.timezone="Asia/Kolkata"

Set a cron timezone

You can set a specific timezone for your crons so they don’t run in your app runtime timezone (or container timezone if no app runtime timezone is set on your project). To do so, set the timezone top-level property in your app configuration.

Get Started

Core Concepts

Configure Apps & Services

Build, Deploy & Run

Manage Projects

Manage Environments

Manage Resources

Observability & Metrics

Integrations

Troubleshooting

Resources

Set an app runtime timezone

Set a cron timezone

​Set an app runtime timezone

​Set a cron timezone

Set an app runtime timezone

Set a cron timezone