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

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

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 ❤️

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 ❤️

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

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

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

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

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

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

1.14.0 (2020-07-15)

New software versions

• fin v1.97.0
• VirtualBox v6.1.10
• docker v19.03.5 (v19.03.9 on Debian/Ubuntu)
• docker-compose v1.26.0
• Switched vhost-proxy to docksal/vhost-proxy:1.6
• Switched cli image to docksal/cli:2.11-php7.3

New features

• Ubuntu 20.04 (focal) LTS support
• PHP 7.4 (docksal/cli:2.11-php7.4)
• Xhprof integration (#1270)
• Project autostart switch (#1285)

Changes and improvements

• Added DOCKSAL_DNS_DISABLED global config switch to allow disabling the build-in docksal-dns service (#1376)
  • Use this as a transition to the new docksal.site base domain for projects
  • Helps address the DNS port binding issue on macOS (listen udp 0.0.0.0:53: bind: address already in use)
• Added proxy variables to fin run-cli (#1252)
• Passing the database argument when running fin db cli (#1263)
• Changed uuid generation method (#1287)
• Added a check that the VM IP matches what we expect
• Fixed issue "error while removing network: network id has active endpoints" (#1293)
• Fixed environment variables for fin exec running scripts (#1289)
• Fixed issue with starting cli from vhost-proxy and missing ssh agent socket (#1291)
• Fixed logic with SSH_AUTH_SOCKET (#1308)
• Allow overriding DOCKSAL_DNS_DOMAIN with Docker Desktop 2.2.0.0+
  • If users want to stick with the .docksal TLD on Docker Desktop for Windows, they can do so by manually pinning DOCKSAL_DNS_DOMAIN (fin config set --global DOCKSAL_DNS_DOMAIN=docksal) and then use fin hosts add project.docksal to manage DNS records using the OS hosts file.
• Added logging settings for system containers (#1354)

Documentation

• Added a section for locally-trusted HTTPS certs using mkcert (#1370)
• Explained SSH agent proxy functionality (#1253)
• Added a section for xhprof (#1270)
• Updated NFS mounts and configuration (#1261)
• Added troubleshooting docs for NFS issues on macOS Catalina (#1371)
• PostreSQL support in stacks (#564)
• Configuration information for Nginx
• Lots minor fixes in docs
• ElasticSearch persistent settings
• Docker container logging
• Adding a custom certificate for a project (#1359)
• Accessing environment variables in cron jobs (#1365)
• Updated DNS settings docs (#1376)

1.13.3 (2020-05-14)

IMPORTANT

If you have ports 53/80/443 in use on your Mac or Windows host, then you would need to either:

• Stop the service(s) utilizing those ports on the host (see #1348)
• Stick with Docker Desktop v2.1.0.5 and Docksal v1.13.2 (DOCKSAL_VERSION=v1.13.2 fin update) until we find a better way to address upstream regressions with newer Docker Desktop versions.

New software versions

• fin v1.95.0

Changes and improvements

• Docker Desktop 2.3.0.2 compatibility fixes (Mac and Windows)
  • Bind system services to 0.0.0.0 by default in virtualized environments (fixes #1268, fixes #1342)
  • Dropped the dependency on DockerNAT interface on Windows (fixes #1276)
    • Do not configure DNS resolver with Docker Desktop for Windows
    • Use the external docksal.site TLD with Docker Desktop for Windows v2.2.0.0+. This is necessary to have a working setup out of the box without the need to ask the user to manually configure DNS records using "fin hosts".

Experimental

• Try the new external TDL for your Docksal projects!

  fin config set --global DOCKSAL_DNS_DOMAIN=docksal.site
  

  Note: This option is enforced with Docker Desktop for Windows 2.2.0.0+

1.13.2 (2019-03-15)

Documentation

• Added a section about setting/checking DOCKSAL_VOLUMES (#1275, #1296)
• Added warnings in install docs about Docker Desktop versions (#1268)

1.13.1 (2019-12-18)

New software versions

• fin v1.93.0

Changes and improvements

• Added IDE_PASSWORD variable to IDE stack file (#1241)
• Fixed Xdebug configuration issues (#1242)
  • Updated PHP_IDE_CONFIG variable in services.yml
  • Added back xdebug settings workaround for backward compatibility (https://github.com/docksal/docksal/issues/1238#issuecomment-566779905)
• Fixed SSH_AUTH_SOCK being unset for custom commands (#1248)
• Improved performance and functionality of fin bash (#1247)
• Added user and shell labels on cli in sercvice.yml
• Improved messaging in ssh_key()
• Cleaned up items pending to be removed as per TODO notes

Documentation

• Revamped Xdebug docs

1.13.0 (2019-11-27)

New software versions

• fin v1.92.2
• docker v19.03.4, docker-compose v1.24.1, docker-machine v0.16.2
• VirtualBox v5.2.34
• System services
  • docksal/ssh-agent:1.3
    • TCP proxy mode for SSH agent socket
• Stack services
  • Switched cli to docksal/cli:2.10-php7.3 - PHP 7.3 is now the default version in all PHP stacks
    • Switched to Debian 10 (Buster) based upstream PHP-FPM images
    • PHP 5.6 and 7.0 and no longer supported
      • docksal/cli:2.6-php5.6 and docksal/cli:2.6-php7.0 are the last images that included these EOL PHP versions
    • VS Code Server integration
      • See Coder Web IDE docs for more details
    • Updated versions for cli tools
    • Updated xdebug (v2.7.2), so it works with PHP 7.3 (docksal/docksal#1105)
    • Added sqlsrv/pdo_sqlsrv extensions for PHP 7.3
    • See docksal/cli v2.7.0+ release notes for more details

Changes and improvements

• Switched Docker Desktop to NFS volumes on Mac by default. See volumes docs for more details.
  • Existing Mac users will need to manually switch to NFS mode. This ensures we do not break existing project stacks as the switch requires a fin project reset.
• IDE mode overhaul
  • IDE runs in a separate container instead of inside cli
  • Requires docksal/cli v2.10+
  • IDE URL is now http://ide-${VIRTUAL_HOST} (using dash instead of dot separator in the URL)
  • IDE URL is printed along with Project URL after "fin up" in the console output (when IDE_ENABLED=1)
• Implemented ssh-agent forwarding on Linux, Mac and Windows
  • Added DOCKSAL_SSH_AGENT_USE_HOST variable to control which ssh-agent is used (host vs docksal) (#1080). See variables docs for usage details.
  • Implemented an SSH proxy over TCP to support this use case on Mac and Windows (#1088)
• Allowed creating projects from a custom git repo (#1154)
  • Example: fin project create --name=myproject --repo=https://github.com/org/project.git
• Fixed a regression in git binary detection on Mac (#1084)
• Fixes in provider integrations (fin pull)
  • switched to drush8 for Acquia pull commands (#1087)
  • fixed issue where date on cached db isn't checked properly (#1092)
  • fixed issue with backup ID retrieval in provider_pull_acquia_db() (#1093)
• Increased custom command finding depth from 2 to 4 (#1116)
• Fixed compatibility with WSL in Windows 10 v1903 (#1103)
• Fixed installation issues on Play-with-Docker / Alpine (#1233)
• Added IPv6 localhost termination in fin hosts add (#766)
• Added DRUSH_OPTIONS_URI to the cli service (#1115)
• Including MySQL settings in cli service definition
  • With MySQL settings visible in cli, they can be assumed from the environment instead of having to hard-code in app code
• Generating actual default init script file in the init wizard
• Added IMAGE_RUN_CLI variable which can be used to override the image via the global docksal.env
• Added fin config yml as a quick way to export static config (#728)
• Added DOCKSAL_CONFIRM_YES variable to allow auto-answering yes to all yes/no confirms (#1186)
• Added Drupal 8 BLT version for project create option (#1175)
• Added --quiet option for fin ssh-key add command (#1179)
• Made health check timeout configurable (#1178)
• Allowed setting shell and user for fin exec and fin bash commands using io.docksal.shell and io.docksal.user container labels (#1122)
• Refactored tests, made them faster, simpler (#1207)
• Fixed the issue with osxfs:cached and named volumes (#1218)
• Allowed VM primary and secondary storage capacity to be configurable. (#1222)
• Switched travis build to ubuntu 18.04 (bionic)
• DOCKSAL_LOCK_UPDATES=1 now disables checks for updates. Previously, it would check, but not allow an update (#1081)
• Added a prompt to review release notes after update
  • Also opening release notes URL in a browser after update on Macs

Documentation

• "Getting Started" docs overhaul
  • Aiming for a straightforward experience for new users
  • Two paths: 1) from scratch/existing project, 2) from a boilerplate repo
  • Putting emphasis on fin init as a single step to bootstrap a project "from zero to hero"
• Revamped volumes documentation (#1221)
• Revamped variables documentation, added variable scope (#1173)
• Added Acquia BLT documentation (#1190)
• Added documentation for Portainer (#1170)
• Added macOS firewall troubleshooting docs (#1196)
• Added VPN troubleshooting docs (#1203)
• Added documentation on multisite setup (#1209)
• Added VS Code documentation (#1212)
• Added WordPress settings documentation (#1144)
• Added wording about what an addon is
• Added documentation on passing environment variables (#1128)
• Added message about RAM needed for composer projects (#1189)
• Added notice about spaces in project paths (#1134)
• Changed link of sample projects to the Docksal boilerplate list on Github (#1139)
• Updated boilerplate repo URLs
• Added warning about required index page in docroot in zero-config docs section (#1141)
• Updated ngrok.yml config file documentation (#1100)
• Documented the cli startup.sh script (#751)
• Updated xdebug docs (#1158)
• Updated phpcs docs (#1160)
• Removed fin vm ip command from documentation and listed the canonical Docksal IP
• Fixed URL to edit docs
• Remove Babun mentions (#1204)

• See #1220 for the upcoming release notes
• Changes v1.13.0-rc1...v1.13.0-rc2

See https://github.com/docksal/docksal/pull/1220 for the upcoming release notes

1.12.3 (2019-06-12)

RELEASES CONTAIN BREAKING CHANGES

There was a breaking change in Docker 18.09.0.
If you are using VirtualBox mode (Boot2Docker), your VM will need to be reset during the update.
See Boot2Docker update for more information.

DEPRECATION NOTICE

• Versions of Windows prior to Windows 10 are no longer supported
• Babun (Windows) is deprecated and is no longer supported
• WSL is now the default and the only supported installation mode on Windows

New software versions

• fin v1.86.2

Changes and improvements

• Fix condition in fin exec that prevented executing a command in an arbitrary container (#1074)
• Call xargs in a cross-platform compatible way in fin cleanup (#1076)

Documentation

• Updated fin command docs
• Updated stock stacks description

1.12.2 (2019-06-05)

RELEASE CONTAINS BREAKING CHANGES

There was a breaking change in Docker 18.09.0.
If you are using VirtualBox mode (Boot2Docker), your VM will need to be reset during the update.
See Boot2Docker update for more information.

DEPRECATION NOTICE

• Versions of Windows prior to Windows 10 are no longer supported
• Babun (Windows) is deprecated and is no longer supported
• WSL is now the default and the only supported installation mode on Windows

New software versions

• fin v1.86.0

Changes and improvements

• Allowed custom commands and addons to be located in symlinked directories (#1036)
• Added a missing --rm in a docker run call in is_docker_path to cleanup existed containers (#1039, #1064)
• Refactored fin cleanup
  • Not cleaning up dangling volumes not created/managed under Docksal (#1056)
• Improve error reporting:
  • Error out if DOCKSAL_STACK definition is incorrect (#1051)
  • Error out fin exec if target container is not found (#1051)
• Removed UNISON_USER and UNISON_GROUP from volumes-unison.yml (#1049)
  • They are not needed anymore due to docksal/unison#7
• Reverted to using wmic.exe to get logical drives list on Windows (#1059)
• Added a trigger to short fin pull tests in CI

Documentation

• Added docs on available Docksal Stock Images https://docs.docksal.io/stack/images-versions/
• Updated docs on the DOCKSAL_ENVIRONMENT variable use cases (#1041)
• Updated docs for web service settings and multiple webs use case
  • Added a more meaningful example for additional virtual hosts with Apache
  • Added Nginx docs
• Updated docs on NodeJS use case in cli
• Updated Windows SMB Troubleshooting docs with a case when drives are not shared in Docker Desktop (#1040)
• Update fin config docs (#1035)

1.12.1 (2019-04-09)

RELEASE CONTAINS BREAKING CHANGES

There was a breaking change in Docker 18.09.0.
If you are using VirtualBox mode (Boot2Docker), your VM will need to be reset during the update.
See Boot2Docker update for more information.

DEPRECATION NOTICE

• Versions of Windows prior to Windows 10 are no longer supported
• Babun (Windows) is deprecated and is no longer supported
• WSL is now the default and the only supported installation mode on Windows
• Removed deprecated db service in stacks/services.yml (use mysql service instead in custom stacks)

New software versions

• fin v1.85.1

Changes and improvements

• Added missing stack-pantheon.yml file to the list of stacks to download during update/install (#1024)
• Fixed VirtualBox 6.0 compatibility in fin vm rm (#1021)
  • Note: The official latest stable and supported VirtualBox version is still 5.2.26.
• Fixed DNS detection on Windows (#1022)

Documentation

• Updated installation docs
• Made Docker Desktop the recommended option for Mac users (to match the info on docksal.io)