Releases: docksal/docksal
Releases · docksal/docksal
v1.19.0
1.19.0 (2024-05-24)
New software versions ✨
- fin v1.118.0
- Docker Desktop v4.29.0 (build 145265)
- Docker / Docker CLI v26.0.0
- Docker Compose v2.26.1
- New image versions
Changes and improvements ⚙️
- macOS Sonoma 14.4 compatibility
- Refactored NFS configuration
- Improved NFS diagnostics
- Docker Compose new version compatibility
- dropped the obsolete
version
prop in stack configs
- dropped the obsolete
- Disabled
dns
service and resolver configuration by default- Both will be completely removed in the following release
- Replaced
mailhog
service withmailpit
- Updated
fin project create
wizard list - Added
--build
option todocker-compose create
to use dockerfiles - Using sudo to create
FIN_AUTOCOMPLETE_PATH
(which is usually owned by root) - Updated GitHub Actions config
Documentation 📖
- Extended "fin help update" output
- Various small updates
Contributors 🤓
@lmakarov, @shelane, @obriat, @tomclopez, @onefreewalk
Sponsors 🤑
@markaspot, @lpeabody, @paulsheldrake, @andreyzb, @twfahey1, @johnoltman65, ❤️ You ❤️
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
- 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 officialcloudflare/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
- PHP 8.1 is now the default version in the
default
stack and infin 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
andmailhog
) now use multi-arch (amd64/arm64) images
- All services in the Docksal catalog (except
- 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 withdocksal-dns
internal DNS resolver is deprecated- Follow the instructions to switch to the new public base domain -
.docksal.site
- Follow the instructions to switch to the new public base domain -
- 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 onlatest
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 🤑
v1.16.2
v1.16.1
1.16.1 (2021-09-27)
New software versions
- fin v1.107.0
Changes and improvements
- Use
ifconfig
command instead ofip
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 andrun-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 existing2.1
stack files. - Moved
dns
,healthchecks
, andlogging
settings intox-common-settings
inservices.yml
(yaml anchors are now supported!)
- As the
- 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
andshowmount -e
- Showing
- 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
withcommand
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 with0
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).
- This will prevent breaking changes for custom stacks or stacks that pin the
- Added sponsor prompt after
fin update
- Using
busybox
instead ofdocksal/empty
image inis_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
inservices.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
anddocksal-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 todocksal/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 topostgres: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