@Marvin I experience encoding issues in Prefect Server (version 2.19) deployed on Linux with docker-compose: web-UI shows gibberish symbols for Cyrillic letters, e.g. in deployment description or parameter values. What can I check or do to fix it?

It seems that there's no specific documentation addressing encoding issues with Cyrillic letters in the Prefect UI when using Docker. However, here are some generalized steps and checks you can follow: 1. Locale Settings: Ensure that the Docker container is using an appropriate locale that supports Cyrillic characters (e.g.,

ru_RU.UTF-8

). 2. Dockerfile Configuration: If you have a custom Dockerfile or can modify one, ensure that it sets the locale correctly. Example:

RUN apt-get update && \
       apt-get install -y locales && \
       locale-gen ru_RU.UTF-8 && \
       update-locale LANG=ru_RU.UTF-8
   ENV LANG ru_RU.UTF-8
   ENV LANGUAGE ru_RU:ru
   ENV LC_ALL ru_RU.UTF-8

3. Docker Compose Environment Variables: Ensure that the

docker-compose.yml

file sets the environment variables for locale correctly.

yaml
   version: '3.1'
   services:
     prefect-server:
       image: prefecthq/prefect:latest
       environment:
         - LANG=ru_RU.UTF-8
         - LANGUAGE=ru_RU:ru
         - LC_ALL=ru_RU.UTF-8

4. Database Encoding: Check that the database used by Prefect Server supports UTF-8 encoding and that it's correctly set up. 5. Python Settings: Ensure that the Python environment within the Docker container is set to use UTF-8 encoding.

python
   import sys
   import locale
   print(sys.getdefaultencoding())
   print(locale.getpreferredencoding(False))

If none of these steps resolves the issue, consider raising an issue on the Prefect GitHub repository with detailed information about your setup. Sources: - Guide to Prefect with Docker: https://docs.prefect.io/latest/integrations/prefect-docker/worker/ - Prefect Deployment Guides: https://docs.prefect.io/latest/guides/prefect-deploy/ - GitHub Issue (related to Docker issues): https://github.com/PrefectHQ/prefect/issues/3680

@Marvin It seems that problem appears when I deploy a deployment from my local machine. When I deploy from server container then there is no encoding problem.

The issue appears to be caused by differences in encoding settings between your local machine and the server where the container runs. Here's a step-by-step approach to fix the encoding problem: 1. Set Environment Variables Locally: Ensure that your local environment where you run the deployment has the encoding set properly. You can add these in your shell configuration file (

~/.bashrc

,

~/.zshrc

, etc.):

sh
   export LANG=ru_RU.UTF-8
   export LANGUAGE=ru_RU:ru
   export LC_ALL=ru_RU.UTF-8

2. Docker Configuration: When deploying from your local machine, ensure that the Docker container inherits the locale settings. In your

docker-compose.yml

, add the locale settings:

yaml
   version: '3.1'
   services:
     prefect-server:
       image: prefecthq/prefect:latest
       environment:
         - LANG=ru_RU.UTF-8
         - LANGUAGE=ru_RU:ru
         - LC_ALL=ru_RU.UTF-8

3. Ensure Consistent Python Encoding: Python should also be aware of the proper encoding settings. Check your local Python environment's encoding:

python
   import sys
   import locale
   print(sys.getdefaultencoding())
   print(locale.getpreferredencoding(False))

If it is not set to UTF-8, you may need to adjust your Python environment. 4. Check Deployment Configuration: Ensure that when you create deployments, the text encoding for metadata (like deployment descriptions) is set to UTF-8. In your script or application, you can explicitly specify the encoding when dealing with text:

python
   deployment_description = "Описание".encode("utf-8").decode("utf-8")

Maintaining consistent encoding settings across your development environment and deployment environment is crucial to mitigate such issues. For further details, consider referring to these sources: - Prefect Deployment Guide: https://docs.prefect.io/latest/guides/prefect-deploy/ - Prefect Deployment YAML Editing: https://docs.prefect.io/latest/concepts/deployments-block-based/ If the problem persists, raising an issue on GitHub with your specific deployment setup might yield additional insights.