Sign inSign up

ubuntu/temporal-server

Verified Publisher

By Canonical

•Updated about 1 year ago

Temporal Server, enabling the execution of Workflows in a resilient manner.

Image
Data science
0

3.5K

ubuntu/temporal-server repository overview

ubuntu/temporal-server is a rock for temporal server maintained by Canonical⁠.

Temporal is a durable execution platform that enables developers to build scalable applications without sacrificing productivity or reliability. The Temporal server executes units of application logic called Workflows in a resilient manner that automatically handles intermittent failures, and retries failed operations.

⁠Temporal Server Configuration

Temporal server must be provided with a configuration file to start up sucessfully. We do not include any default configurations in the image. Instead, we expect the user to either add a configuration file in the deployed container or mount a volume with the config file in the container.

Some development configuration files can be found in the Temporal repository⁠.

[Learn more about temporal server⁠]

⁠Tags and Architectures

NOTE: These tags follow a specific naming convention that respects the concept of channels⁠.

TagsSupported untilVersionBaseArchitectures
View deprecated tags
TagsSupport ended onUpgrade Path
1.23.1-24.04_edge
aliases1-24.04_edge, 1.23-24.04_edge
08/2025 -

⁠Get started

This rock's entrypoint is Pebble, a container-optimized init process that enables the orchestration of a collection of local service processes as an organized set.

[Learn more about Pebble⁠]

⁠Inspect

To view the Pebble services⁠ and checks⁠ defined in this rock:

docker run --rm ubuntu/temporal-server:1.23.1-24.04_edge plan
⁠Run

To run this rock, use any of the usual container runtimes, for example, docker:

docker run --name temporal-server-container \
    -d -p 7233:7233 -e SQL_HOST=1.2.3.4 -v /path/to/temporal/config.yaml:/etc/temporal/config/config.yaml \
    ubuntu/temporal-server:1.23.1-24.04_edge

Temporal server starts and listens on its configured ports.

To obtain a runnable configuration, refer to the official repository⁠.

⁠Get logs

To view the logs of the running container, run:

docker exec temporal-server-container pebble logs

Or, for a specific service:

docker exec temporal-server-container pebble logs <service>
⁠Monitor health checks

Rocks may have predefined health checks that you can list by running:

docker exec temporal-server-container pebble checks

The overall health of your container can be inspected via:

docker exec temporal-server-container pebble health

⁠Configuration

⁠Environment variables
OptionDescriptionDefault
TEMPORAL_ROOTRoot directory of Temporal execution environment.None
TEMPORAL_CONFIG_DIRConfig directory path relative to the Temporal root.None
TEMPORAL_ENVIRONMENTRun time Temporal environment.None
TEMPORAL_AVAILABILITY_ZONETemporal's availability zone.None
TEMPORAL_ALLOW_NO_AUTHBoolean to allow no authorizer.None
SQL_HOSTHostname or IP address of SQL host to connect to with temporal-sql-tool.None
SQL_PORTPort of SQL host to connect to with temporal-sql-tool.None
SQL_USERUser name used for authentication when connecting to SQL host with temporal-sql-tool.None
SQL_PASSWORDPassword used for authentication when connecting to SQL host with temporal-sql-tool.None
SQL_DATABASEName of SQL database used with temporal-sql-tool.None
SQL_PLUGINName of the SQL plugin for temporal-sql-tool.None
SQL_CONNECT_ATTRIBUTESSQL connect attributes for temporal-sql-tool.None
SQL_TLSEnable TLS over SQL connection with temporal-sql-tool.None
SQL_TLS_CERT_FILESQL TLS client certificate path for temporal-sql-tool.None
SQL_TLS_KEY_FILESQL TLS client key path for temporal-sql-tool.None
SQL_TLS_CA_FILESQL TLS client CA file for temporal-sql-tool.None
SQL_TLS_SERVER_NAMEOverride for target server name with temporal-sql-tool.None
SQL_TLS_DISABLE_HOST_VERIFICATIONDisable TLS host name verifaction with temporal-sql-tool (tls must be enabled).None
TEMPORAL_CLI_ADDRESShost:port for Temporal frontend service used by tdbg.None
TEMPORAL_CLI_NAMESPACETemporal workflow namespace used by tdbg.None
TEMPORAL_CONTEXT_TIMEOUTOptional timeout for context of RPC calls in seconds for tdbg.None
TEMPORAL_CLI_TLS_CERTPath to x509 certificate used by tdbg.None
TEMPORAL_CLI_TLS_KEYPath to private key used by tdbg.None
TEMPORAL_CLI_TLS_CAPath to server CA certificate used by tdbg.None
TEMPORAL_CLI_TLS_DISABLE_HOST_VERFICATIONDisable TLS host name verification for tdbg (tls must be enabled).None
⁠Volumes
OptionDescriptionDefault
-v <path>:/etc/temporal/config/config.yamlLocal configuration file for Temporal server.None
⁠Ports
OptionDescriptionDefault
-p <port>:6933Expose Temporal's fronted service membership endpoint.None
-p <port>:6934Expose Temporal's history service membership endpoint.None
-p <port>:6935Expose Temporal's matching service membership endpoint.None
-p <port>:6939Expose Temporal's worker service membership endpoint.None
-p <port>:7233Expose Temporal's frontend service GRPC endpoint.None
-p <port>:7243Expose Temporal's frontend service HTTP endpoint.None
-p <port>:7234Expose Temporal's history service GRPC endpoint.None
-p <port>:7235Expose Temporal's matching service GRPC endpoint.None
-p <port>:7239Expose Temporal's worker service GRPC endpoint.None

[Report a bug⁠] [Contribute⁠]

Canonical is the provider of this container image. It is the user's responsibility to ensure that any use of this image complies with any relevant licenses for all software contained within, as well as with Canonical’s IP Policy⁠.

Tag summary

Content type

Image

Digest

sha256:d429a4fa2…

Size

163.5 MB

Last updated

about 1 year ago

docker pull ubuntu/temporal-server:1.23.1-24.04_edge

This week's pulls

Pulls:

20

Last week