v1.18.2

1.18.2 (2023-04-03)

❗IMPORTANT: This release addresses a bug in the update process introduced in v1.17.0.

Please use the command below to force the update to this release.

DOCKSAL_VERSION=v1.18.2 fin update

New software versions ✨

• fin v1.113.2

Changes and improvements ⚙️

• Refactored version overrides during updates
• Replaced the legacy set-output command in GitHub Actions

v1.18.1

1.18.1 (2023-03-31)

❗IMPORTANT: This release addresses a bug in the update process introduced in v1.17.0.

Please use the command below to force the update to this release.

DOCKSAL_VERSION=v1.18.1 fin update

New software versions ✨

• fin v1.113.0

Changes and improvements ⚙️

• Fixed network issues after project stack stop/restart
• Fixed update process
• Switched CI builds to actions/checkout@v3

Documentation 📖

• Updated Docker Desktop links in setup.md docs

v1.18.0

1.18.0 (2023-03-12)

New software versions ✨

• fin v1.112.0
• Docker Desktop v4.17.0
• Docker v20.10.23
• Docker Compose v2.15.1
• VirtualBox v6.1.42
• New image versions
  • docksal/cli v3.3
• Switched all stacks to PHP 8.1 (docksal/cli:php8.1-3.3 image)

Changes and improvements ⚙️

• macOS Ventura 13.0 compatibility
  • Adjusted NFS mount read/write buffers
• Ubuntu 22.04 compatibility
• Made DOCKSAL_ENVIRONMENT variable visible in custom commands and add-ons by default
• Updated Solr version to v7 for the Acquia stack
• Fixed fin image registry <image_name> command
• Fixed fin share command
• Fixed network settings in Gitpod
• Updated the list of options for fin project create (added Drupal 10 options, removed Drupal 8)
• Updated xhprof image to work with arm64/Apple Silicone
• Switched cloudflared service to the official cloudflare/cloudflared image (which now supports arm64)
• Dropped legacy xdebug v2 remote_host option in stack configs
• Improved fin sysinfo output (added green/red colors for PASS/FAIL tests)

Documentation 📖

• Adding Mutagen option in Shared Volumes docs
• Updated PHP version docs
• Removed Solr 4 instructions and updated the listed default version to Solr 8
• Various small updates

Contributors 🤓

@lmakarov, @froboy, @paulsheldrake, @shelane, @halisonfernandes, @obriat, @khaledzaidan, @nicoschi, @shaal,
@matthiasseghers, @eloso-uk, @sean-e-dietrich, @danshumaker, @rosenstrauch, @jasonawant, @anpolimus,

Sponsors 🤑

@markaspot, @lpeabody, @alexander-danilenko, @andreyzb, @twfahey1, @johnoltman65, ❤️ You ❤️

v1.17.0

1.17.0 (2022-04-15)

New software versions ✨

• fin v1.110.1
• Docker Desktop v4.4.2+ (build 73305)
• Docker v20.10.12 (boot2docker pinned at v19.03.5)
• Docker Compose v2.1.0
• VirtualBox v6.1.32
• New multi-arch (amd64/arm64) image releases
  • docksal/vhost-proxy v1.8
  • docksal/ssh-agent v1.4
  • docksal/dns v1.2
  • docksal/cli v3.2
  • docksal/apache v2.5
  • docksal/nginx v1.2
  • docksal/mysql v2.0
  • docksal/mariadb v1.3
  • docksal/varnish v3.1
• PHP 8.1 is now the default version in the default stack and in fin run cli command
  • See docs on switching/pinning PHP versions

Changes and improvements ⚙️

• 🎉 Apple M1 and Linux ARM64 support 🎉
  • All services in the Docksal catalog (except solr and mailhog) now use multi-arch (amd64/arm64) images
• Switched to Docker Compose v2 (v1 support dropped)
  • Running v2 in compatibility mode (forces the use underscores instead of hyphens in container names (like in v1)).
• Use of .docksal base domain along with docksal-dns internal DNS resolver is deprecated
  • Follow the instructions to switch to the new public base domain - .docksal.site
• New fin share-v2 command
  • Creates a temporary public URL for the project using a free Cloudflare Tunnel
• Project auto-start is now disabled by default for local environments (still ON by default for CI environments)
• Included Docksal version in fin --version output
  • no more confusion which Docksal vs fin version you are running
• Gitpod Integration
• fin pull is now an addon (removed from fin core)
• Fixed VirtualBox support on macOS 12 Monterey
• Removed Drupal 8 options from fin project create (Drupal 8 is EOL)
• Bumped all services to the most recent image tags
  • We'll stick to the most recent versions by default and pin versions in hosting platform specific stacks
  • Current default versions:
    • Apache 2.4
    • Nginx 1.20
    • MySQL 8.0
    • MariaDB 10.6
    • Postgres 14.2
    • PHP 8.1
    • Varnish 7.0
    • Memcached 1.6
    • Redis 6.2
    • Solr 8.6-edge (legacy image, likely to be deprecated)
    • Mailhog 1.0.1
    • Elasticsearch 8.1.2
    • cloudflared latest (has to stay on latest as Cloudflare makes frequent updates and blocks older client versions)
• Switched to MariaDB 10.4 as the default db service in all hosting platform stacks
  • MariaDB 10.4 functions as limited drop-in replacements for MySQL 5.7, as far as InnoDB is concerned
• Updated Acquia stack versions
  • Apache 2.4
  • MariaDB 10.4 (MySQL 5.7 drop-in replacement)
  • PHP 7.4
  • Varnish 6.6
  • Memcached 1.6
  • Apache Solr 4.5
• Updated Pantheon stack image versions
  • Nginx 1.20
  • MariaDB 10.4 (MySQL 5.7 drop-in replacement)
  • PHP 7.4
  • Varnish 6.6
  • Redis 5.0
  • Apache Solr 3.6
• Updated Platform.sh stack image versions
  • Nginx 1.20
  • MariaDB 10.4 (MySQL 5.7 drop-in replacement)
  • PHP 7.4
  • Redis 5.0
• Switched to Blackfire Agent v2 in stacks (requires docksal/cli v3.1.0+)

Documentation 📖

• Expanded docs around project auto start/stop features
• Added instructions for installing an addon globally
• Added documentation on composer memory issues
• Reorganized and updated help sections in fin + misc updates in fin help
• Added disk space issue to common issues
• Updated MailHog docs
• Added Github Actions build badge in README.md
• Added section on common issues for Apple MDM (Mobile Device Management) troubleshooting
• Updated docs around disabling built-in DNS resolver (docksal-dns)
• Added Cloudflare Tunnel (fin share-v2) docs
• Added example on how to override solr service image
• Added sponsor documentation

Contributors 🤓

• @lmakarov, @sean-e-dietrich, @shelane, @froboy, @waako, @marvoey, @paulsheldrake, @vladtulku, @JDDoesDev

Sponsors 🤑

• @markaspot, @froboy, @lpeabody, @alexander-danilenko, @paulsheldrake, @610, @twfahey1, @johnoltman65
• ❤️ You ❤️

v1.16.2

1.16.2 (2021-09-28)

New software versions

• fin v1.107.1

Changes and improvements

• Fixed terminal colors in fin broken on some systems after update to v1.16.1

v1.16.1

1.16.1 (2021-09-27)

New software versions

• fin v1.107.0

Changes and improvements

• Use ifconfig command instead of ip command on Mac
• Minor refactoring in Github Actions
• Minor changes to UI in fin
  • Revised terminal colors and notification types

Documentation

• Simplified troubleshooting docs around Docker Machine TLS certs
• Replaced references to Gitter with GitHub Discussions
• Added documentation for the HOSTING_* variables on the configuration variables page

v1.16.0

1.16.0 (2021-08-03)

New software versions

• fin v1.106.0
• Docker Desktop v3.4.0 (65384)
• Docker v20.10.7
• Docker Compose v1.29.2
• VirtualBox v6.1.22
• Switched vhost-proxy service to docksal/vhost-proxy:1.7 (multi-arch amd64/arm64 image)
• Switched cli service and run-cli command to docksal/cli:php7.4-3.0
  • This is a major version upgrade of the image
  • arm64 support
  • PHP 8.0 image
  • Xdebug v3 PHP extension
  • Dropped some tools, not all tools available for arm64, terminus not available for PHP 8.0
• Switched mysql service to docksal/mysql:5.7-1.5

New features

• Switched stack files to Docker Compose file format v3.9
  • As the "version" property is now optional, this change is fully backwards compatible with the existing 2.1 stack files.
  • Moved dns, healthchecks, and logging settings into x-common-settings in services.yml (yaml anchors are now supported!)
• Platform.sh alike stack (stack-platformsh.yml) based on platformsh-templates/drupal9
• fin acli to top level command (using acquia/cli)

Changes and improvements

• Switched from Travis CI to Github Actions for CI/CD
• Enhanced NFS diagnostics in fin sysinfo
  • Showing nfsd status and showmount -e
• Allow addons/scripts to use variables and functions defined in fin by sourcing it (source $(which fin))
• Removed deprecated services/web
• Fixed NFS mounts with Docker Desktop (Virtualization Framework/M1) in macOS Big Sur
• Added check for existing host name before adding to eliminate duplicates
• Replaced which with command in shell function wrappers (pwd, docker, docker-compose) (#1496)
• Dropped docker-machine wrapper, as microsoft/WSL#4078 is now resolved.
• Fixed exit code at the end of fin update - without this, fin update would exit with 0 even if there were errors during the update process.
• Updated XHProf service to work with XHProf 2.x and 3.x (#1507)
• Updated IDE settings for XDebug v3 compatibility
• Preserving compatibility with XDebug v2
  • This will prevent breaking changes for custom stacks or stacks that pin the CLI_IMAGE version to a version with XDebug v2 (docksal/cli v2.12 and below).
• Added sponsor prompt after fin update
• Using busybox instead of docksal/empty image in is_docker_path check (busybox is multi-arch)
  Included WSL in Windows usage reporting

Documentation

• Added documentation for Xdebug 3
• Added documentation for Platform.sh alike stack
• Bumped WSL Ubuntu v20.04 in docs
• Added warning for changing volume mount type (#1486)
• Update docs for Acquia CLI (acquia/cli) and add to top level commands (#1481)
• Updated drush links in doc for fin pull
• Blocked search engines on feature/version branches of the docs
• Added a redirect for a most common URLs linking to the old RTD docs website
• Added documentation version link for develop branch as "Upcoming"
• Added example and help on obtaining info on latest available images
• Added documentation on routing to a custom port (#1526)
• Created CODEOWNERS
• Added Feedback button in docs (#1527)
• Switched to CarbonAds in docs
• Switches community support to GitHub discussions
• Added GitHub Discussions link to docs sidebar menu

v1.15.1

1.15.1 (2021-01-15)

New software versions

• fin v1.103.0

Changes and improvements

• Added COMPOSER_DEFAULT_VERSION in services.yml to support Composer version switching instructions in docs
• Improved flushing DNS cache on macOS
• fin sysinfo improvements
  • rearranged items to be more logical
  • print NFS settings for macOS regardless of the mode (VBOx or Docker Desktop)
  • print DOCKER_HOST unconditionally (may be helpful in any case)
  • list all projects, not just active
  • added connectivity checks
  • added debug information if host DNS check fails
• Added container logging options to docksal-dns and docksal-ssh-agent services
• Added DOCKSAL_CONTAINER_HEALTHCHECK_INTERVAL option
  • Can be used to increase container healthcheck interval and thus help with excessive load produced by healthchecks from many concurrently running containers.
  • Defaults to 10s
• Minor improvements in tests

Documentation

• Moved Composer version docs to tools/composer
• Added "Applications" section
  • Moved Drupal and Wordpress docs to a new section
  • Added Wordpress HTTPS docs
• Fixed links and typos in docs

v1.15.0

1.15.0 (2020-11-20)

New software versions

• fin v1.102.0
• Docker Desktop v2.5.0.1 (49550)
• Docker v19.03.13 (boot2docker pinned at 19.03.5)
• Docker Compose v1.27.4
• VirtualBox v6.1.16
• Switched cli service to docksal/cli:2.12-php7.3
  • Dropped PHP 7.2 (EOL as of 30 Nov 2020)
  • Added Composer v2 (default) with ability to pin to Composer v1
  • Updated NodeJs to the latest LTS release v14.15.0
  • Version bumps for other console tools and runtimes
  • See https://github.com/docksal/service-cli/releases/tag/v2.12.0 for more details.
• Switched postgres service to postgres:10.14-alpine
  • Drupal 9 requires PostgreSQL 10+

New features

• macOS Big Sur support

Changes and improvements

• Update for Elasticsearch 7 compatibility
• Adjusted approach to mounting ssh-agent socket in cli (#1391)
• Prevent PTY allocation for mysql when no TTY is available (#1394)
• Fixed SSH_AUTH_SOCK_DIR owner in cases when the volume directory has been already created by docker (root user)
• Fixed target repositories to match project create selection
• Increased precision in ver_to_int to 4 positions to correctly handle Docker Desktop's a.b.c.d (4 positions) version schema
• Fixed docker_desktop_version check on Windows for recent Docksal Desktop versions
• Fixed bind mounts on Docker Desktop for Mac/Windows v2.3.0.2+
• Changed the value for DOCKASL_VOLUME=disabled (DOCKASL_VOLUME=disable => DOCKASL_VOLUME=disabled)
• Removed Acquia drush commands (Acquia Cloud API v1 is EOL)
• Added support for branch name when using a custom git repo in fin project create

Documentation

• Updated troubleshooting docs on conflicting ports (how to identify which process uses a port)
• Updated VPN troubleshooting docs
  • Mentioned that the VPN workaround is only possible with Docker Desktop for Mac/Windows (see #1397)
• Added docs for missing SSE4.2 CPU instruction set (#1414)
• Fixed Dockerfile example to use proper shell in "Extending Stock Images" docs
• Fixed ssh-key help message
• Added documentation for the Acquia CLI tool (#1387)
• Using entirely custom docker-compose configurations
• Refactored stack configuration docs
• Added Composer version docs in service/cli/settings
• Fixed internal linking in docs
• Wordpress multisite settings
• Updated project's README on GitHub

v1.14.1

1.14.1 (2020-07-20)

New software versions

• fin v1.99.0

New features

• Updated projects to include Drupal 9 boilerplate projects (#1385)

Changes and improvements

• Reverted back to using IP binding for system services with VirtualBox/boot2docker
  • Only use 0.0.0.0 for vhost-proxy and dns with Docker Desktop 2.2.0.0+ on Mac/Windows
• Adjusted DNS settings for containers
  • When docksal-dns is disabled, use DOCKSAL_DNS_UPSTREAM / DOCKSAL_DEFAULT_DNS as primary DNS
• Bump REQUIREMENTS_DOCKER_DESKTOP to 2.1.0.5
  • This is the last version before networking regressions were introduced (#1268)
• Split docker versions based on environment (Linux, Docker Desktop, Boo2docker)
  • REQUIREMENTS_DOCKER='19.03.9' - this is the earliest version available for Ubuntu 20.04 (focal) LTS
  • REQUIREMENTS_DOCKER_DD='19.03.8' - this is the latest version available with Docker Desktop
  • REQUIREMENTS_DOCKER_B2D='19.03.5' - this is the final boot2docker version
  • Removed REQUIREMENTS_DOCKER_DEBIAN
• Better handling of ID_LIKE in is_debian (#1377)
• Added "DOCKSAL: NETWORKING" sections in sysinfo …
  • Replaced "DOCKSAL: DNS"
  • Prints network config variables
  • Added check for DNS resolution/connectivity from containers (and not only host)
• Added dns settings for run-cli

Documentation

• Updated versions in setup docs
  • Added a note in setup docs about Docker Desktop version regressions