{"id":18824663,"url":"https://github.com/embarcadero/paserver-docker","last_synced_at":"2025-07-23T00:03:55.029Z","repository":{"id":49645590,"uuid":"216806312","full_name":"Embarcadero/paserver-docker","owner":"Embarcadero","description":"Docker script for RAD Studio Linux deployment via PAServer","archived":false,"fork":false,"pushed_at":"2025-06-05T13:01:02.000Z","size":226,"stargazers_count":43,"open_issues_count":2,"forks_count":16,"subscribers_count":18,"default_branch":"main","last_synced_at":"2025-07-18T10:42:41.597Z","etag":null,"topics":["cpp-builder","delphi","docker","docker-image","embarcadero"],"latest_commit_sha":null,"homepage":"https://hub.docker.com/r/radstudio/pa-radserver","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Embarcadero.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2019-10-22T12:17:14.000Z","updated_at":"2025-07-13T07:49:28.000Z","dependencies_parsed_at":"2024-01-15T13:11:13.875Z","dependency_job_id":"4560f99b-fa58-403b-8801-65350ee78560","html_url":"https://github.com/Embarcadero/paserver-docker","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/Embarcadero/paserver-docker","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Embarcadero%2Fpaserver-docker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Embarcadero%2Fpaserver-docker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Embarcadero%2Fpaserver-docker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Embarcadero%2Fpaserver-docker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Embarcadero","download_url":"https://codeload.github.com/Embarcadero/paserver-docker/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Embarcadero%2Fpaserver-docker/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266592133,"owners_count":23953107,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-07-22T02:00:09.085Z","response_time":66,"last_error":null,"robots_txt_status":null,"robots_txt_updated_at":null,"robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cpp-builder","delphi","docker","docker-image","embarcadero"],"created_at":"2024-11-08T00:57:07.006Z","updated_at":"2025-07-23T00:03:55.003Z","avatar_url":"https://github.com/Embarcadero.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# RAD Studio PAServer Docker\n\n\u003ca href=\"https://www.embarcadero.com/products/rad-studio\"\u003e\u003cimg alt=\"Embarcadero RAD Studio\" src=\"https://raw.githubusercontent.com/azapater/paserver-docker/main/.github/images/rad-studio-logo.png\" align=\"right\"\u003e\u003c/a\u003e\n\nWelcome to the guide for deploying RAD Studio applications on Linux using Docker and PAServer. This repository offers a Docker script designed to simplify the setup and management of your development environment, allowing RAD Studio developers to deploy and test their applications in a Linux environment.\n\n- **Container available on [Docker Hub][dockerhub-paserver]**\n- [PAServer Documentation][paserver-docs]\n- [More information on RAD Studio][radstudio]\n- Other containers: [InterBase][github-interbase-docker] only, [RAD Server][github-radserver-docker], and [RAD Server with InterBase][github-radserver-interbase-docker]\n\nThe image defaults to running **PAServer** on port `64211` with the _password_ `securepass`\n\nThe 10.x images use Ubuntu 18.04.6 LTS (Bionic Beaver) while the +11.x images use Ubuntu 22.04.1 LTS (Jammy Jellyfish)\n\n## 🚀 How to Use [`run.sh`] Script\n\nThe [`run.sh`] script is your go-to automation tool for setting up and deploying the PAServer application with ease and flexibility. Below are the instructions to utilize this script effectively.\n\n### 📋 Prerequisites\n\nEnsure Docker is installed on your system as this script uses Docker for running the PAServer application.\n\n### 🌟 Features\n\n- **Customizable Name**: Assign a unique name to your PAServer container.\n- **Bind Path**: Designate a custom path for volume mapping.\n- **Detach Mode**: Opt for running your container in the background.\n- **Port Configuration**: Select the port where PAServer runs.\n- **Production Mode**: Activate production mode for your deployment.\n- **Version Control**: Choose the specific PAServer version for deployment.\n- **Password Protection**: Secure your PAServer with a custom password.\n\n### 🛠️ Usage\n\nNavigate to the directory containing [`run.sh`] in your terminal. Execute the script with your preferred options:\n\n```bash\n./run.sh [OPTIONS]\n```\n\n#### 📌 Options\n\n- `--name` or `-n`: Container's name (e.g., `--name=myPAServer`).\n- `--path` or `-pa`: Bind path for volume mapping (e.g., `--path=/my/custom/path`).\n- `--detach` or `-d`: Run container in detach mode (background).\n- `--port` or `-p`: Port for PAServer (e.g., `--port=64211`).\n- `--production` or `-pr`: Enable production mode (`true`).\n- `--version` or `-v`: PAServer version (e.g., `--version=latest`).\n- `--password` or `-pw`: Set a password for PAServer (e.g., `--password=securepass`).\n- `--help` or `-h`: Shows the help of the script.\n\n### 🌈 Examples\n\nRun PAServer in production mode on port 65000 with a custom name and password:\n\n```bash\n./run.sh --name=myPAServer --port=65000 --production --password=mysupersecurepassword\n```\n\nRun PAServer in detach mode with a specific version, bind path, and password:\n\n```bash\n./run.sh --detach --version=12.1 --path=/my/custom/path --password=mysupersecurepassword\n```\n\n### 📝 Note\n\nMake sure you have the necessary permissions to execute `run.sh`. Use `chmod +x run.sh` to make it executable if needed.\n\n## 🐳 Using `docker run` Directly\n\nFor users who prefer a more hands-on approach or wish to customize their deployment further, you can directly use the `docker run` command to start your PAServer container. This method provides flexibility and allows you to manually specify each option.\n\n### 🛠️ Command Structure\n\nThe basic structure of the command to run the PAServer Docker container is as follows:\n\n```bash\ndocker run [OPTIONS] radstudio/paserver:[VERSION]\n```\n\n### 📌 Options\n\n- `-e PA_SERVER_PASSWORD=[PASSWORD]`: Sets the password for the PAServer. Replace `[PASSWORD]` with your desired password.\n- `--name [NAME]`: Assigns a custom name to your Docker container. Replace `[NAME]` with your preferred container name.\n- `-p [PORT]:64211`: Maps a custom port on your host to the PAServer's default port (64211). Replace `[PORT]` with the port number you wish to use.\n- `[DETACH_ARG]`: Use `-d` to run the container in detached mode (in the background).\n- `[BIND_PATH_ARG]`: Use `-v [HOST_PATH]:[CONTAINER_PATH]` to bind a volume for persistent data or configurations. Replace `[HOST_PATH]` and `[CONTAINER_PATH]` with your specific paths.\n\n### 🌈 Examples\n\nTo run the PAServer in a Docker container named `myPAServer`, listening on port 65000, with a password of `mysupersecurepassword`, and running in detached mode, you would use the following command:\n\n```bash\ndocker run -d \\\n           -e PA_SERVER_PASSWORD=mysupersecurepassword \\\n           --name myPAServer \\\n           -p 65000:64211 radstudio/paserver:latest\n```\n\nIf you wish to bind a volume for persistent data, you can add the `-v` option:\n\n```bash\ndocker run -d \\\n           -e PA_SERVER_PASSWORD=securepass \\\n           -v /path/on/host:/root/PAServer/scratch-dir \\\n           --name myPAServer \\\n           -p 65000:64211 radstudio/paserver:latest\n```\n\n#### Using Docker Compose\n\nDocker Compose allows you to define and run multi-container Docker applications. Here is an example `docker-compose.yml` file that demonstrates how to use a Docker image as part of a service, utilizing environment variables for configuration.\n\n```yaml\nversion: '3.8'\nservices:\n  myPAServer:\n    image: radstudio/paserver:latest\n    container_name: myPAServer\n    environment:\n      - PA_SERVER_PASSWORD=${PA_SERVER_PASSWORD} # Environment variable for the server password\n    ports:\n      - '${HOST_PORT}:64211' # Environment variable for the host port\n    volumes:\n      - ${HOST_PATH}:/root/PAServer/scratch-dir # Environment variable for the host path\n    restart: unless-stopped\n```\n\nThis configuration defines a single service called `myPAServer`. It uses the Docker image `radstudio/paserver:latest`. The service configuration includes mapping a port from the host to the container, setting an environment variable for the server password, and mounting a volume from the host to the container. These settings are customizable through environment variables defined in a `.env` file located in the same directory as your `docker-compose.yml`.\n\n```\n# .env file\nPA_SERVER_PASSWORD=securepass\nHOST_PORT=65000\nHOST_PATH=/path/on/host\n```\n\nTo start your application, execute the following command in the directory containing your `docker-compose.yml`:\n\n```bash\ndocker-compose up\n```\n\nThis command initiates the Docker Compose process, which reads the `docker-compose.yml` file and the `.env` file, applying the configurations to start your service as defined.\n\nThis will pull the necessary image (if it's not already locally available), create the defined volumes, set the environment variables, and start your application on the specified ports.\n\n#### 📝 Note\n\nEnsure you replace `/path/on/host` with the actual path you wish to use for volume binding. The `latest` tag can be replaced with any specific version of the PAServer you wish to deploy.\n\n## 🛠️ Customizing Your Docker Image\n\nThis guide will help you customize the PAServer image to suit your specific needs, such as adding additional files or folders, installing extra packages, and making other modifications.\n\n### 📁 Adding Files or Folders\n\nTo add files or folders to your Docker image, use the `COPY` or `ADD` instruction in your Dockerfile. `COPY` is preferred for copying local files, while `ADD` can handle remote URLs and tar extraction.\n\n#### Example: Adding a Configuration File\n\n```dockerfile\nCOPY ./myconfig.conf /etc/myapp/myconfig.conf\n```\n\nThis command copies `myconfig.conf` from your project directory to `/etc/myapp/myconfig.conf` inside the Docker image.\n\n### 📦 Installing Extra Packages\n\nTo install additional packages, you can modify the `RUN` command that installs packages. It's best to combine package installation commands into a single `RUN` instruction to reduce the number of layers in your Docker image.\n\n#### Example: Installing Git and Cmake\n\n```dockerfile\nRUN apt-get update \u0026\u0026 apt-get install -y \\\n    git \\\n    cmake \\\n    \u0026\u0026 rm -rf /var/lib/apt/lists/*\n```\n\nBased on each project, specific libraries may be necessary. This command updates the package lists, installs _Git_ and _Cmake_, and cleans up afterward to keep the image size down.\n\nTo avoid extra layering in the final Docker image, it's good practice to modify the existing `RUN apt-get update` command to include your required libraries.\n\n### 🛠️ Customizing Installation Commands\n\nYou can customize the Dockerfile to change environment variables, download different versions of software, or modify the installation process.\n\n#### Example: Setting a Custom Environment Variable\n\n```dockerfile\nENV MY_CUSTOM_VAR=myvalue\n```\n\nThis sets an environment variable `MY_CUSTOM_VAR` that can be used by your application.\n\n### 🏗️ Building Your Custom Image\n\nAfter customizing your Dockerfile, you can build your Docker image using the `docker build` command.\n\n```bash\ndocker build -t my-custom-paserver:latest .\n```\n\nThis command builds a Docker image named `my-custom-paserver` with the `latest` tag, using the Dockerfile in the current directory.\n\n### 🔑 Using Build Arguments\n\nFor values that might change between builds (like passwords or version numbers), you can use `ARG` instructions in your Dockerfile and pass values with the `--build-arg` option during the build.\n\n#### Example: Specifying a Custom Password\n\n```dockerfile\nARG password=securepass\n```\n\nBuild with a custom password:\n\n```bash\ndocker build --build-arg password=mypassword -t my-custom-paserver:latest .\n```\n\n### 💡 Tips\n\n- This repository provides a [`build.sh`] script that can be used as a template for simplifying custom builds.\n- Currently, this image is only compatible with `linux/amd64`. To avoid potential problems in arm setups, build the image with the arg `--platform linux/amd64`\n\n### 🛡️ Best Practices\n\n- **Minimize Layers**: Combine related commands into single `RUN` instructions where possible.\n- **Clean Up**: Remove unnecessary files and packages to keep the image size down.\n- **Use `.dockerignore`**: Add a `.dockerignore` file to your project to avoid copying unnecessary files into your Docker image.\n- **Secure Secrets**: Avoid hardcoding sensitive information in your Dockerfile. Use build arguments for build-time secrets and environment variables or Docker secrets for runtime secrets.\n\n## License and Copyright\n\nThis software is Copyright \u0026copy; 2024 by [Embarcadero Technologies, Inc.][embarcadero]\n\n_You may only use this software if you are an authorized licensee of an Embarcadero developer tools product. See the latest [software license agreement][embarcadero-license] for any updates._\n\n![Embarcadero(Black)](https://raw.githubusercontent.com/azapater/paserver-docker/main/.github/images/embt-logo-black.png#gh-light-mode-only)\n![Embarcadero(White)](https://raw.githubusercontent.com/azapater/paserver-docker/main/.github/images/embt-logo-white.png#gh-dark-mode-only)\n\n[dockerhub-paserver]: https://hub.docker.com/r/radstudio/paserver\n[radstudio]: https://www.embarcadero.com/products/rad-studio\n[paserver-docs]: http://docwiki.embarcadero.com/RADStudio/en/PAServer,_the_Platform_Assistant_Server_Application\n[github-interbase-docker]: https://github.com/Embarcadero/InterBase-Docker\n[github-radserver-docker]: https://github.com/Embarcadero/pa-radserver-docker\n[github-radserver-interbase-docker]: https://github.com/Embarcadero/pa-radserver-ib-docker\n[embarcadero]: https://www.embarcadero.com/\n[embarcadero-license]: https://www.embarcadero.com/products/rad-studio/rad-studio-eula\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fembarcadero%2Fpaserver-docker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fembarcadero%2Fpaserver-docker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fembarcadero%2Fpaserver-docker/lists"}