Unified, Docker 🐳 powered web development environments for macOS, Windows, and Linux
MIT License
Bot releases are hidden (Show)
❗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
Published by lmakarov over 1 year ago
❗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
actions/checkout@v3
Published by lmakarov over 1 year ago
docksal/cli:php8.1-3.3
image)DOCKSAL_ENVIRONMENT
variable visible in custom commands and add-ons by defaultfin image registry <image_name>
commandfin share
commandfin project create
(added Drupal 10 options, removed Drupal 8)xhprof
image to work with arm64/Apple Siliconecloudflared
service to the official cloudflare/cloudflared
image (which now supports arm64)remote_host
option in stack configs@lmakarov, @froboy, @paulsheldrake, @shelane, @halisonfernandes, @obriat, @khaledzaidan, @nicoschi, @shaal,
@matthiasseghers, @eloso-uk, @sean-e-dietrich, @danshumaker, @rosenstrauch, @jasonawant, @anpolimus,
@markaspot, @lpeabody, @alexander-danilenko, @andreyzb, @twfahey1, @johnoltman65, ❤️ You ❤️
Published by lmakarov over 2 years ago
default
stack and in fin run cli
command
solr
and mailhog
) now use multi-arch (amd64/arm64) images.docksal
base domain along with docksal-dns
internal DNS resolver is deprecated
.docksal.site
fin share-v2
command
fin --version
output
fin pull
is now an addon (removed from fin core)fin project create
(Drupal 8 is EOL)latest
(has to stay on latest
as Cloudflare makes frequent updates and blocks older client versions)db
service in all hosting platform stacks
fin help
fin share-v2
) docssolr
service imagePublished by lmakarov about 3 years ago
fin
broken on some systems after update to v1.16.1Published by lmakarov about 3 years ago
ifconfig
command instead of ip
command on Macfin
HOSTING_*
variables on the configuration variables pagePublished by lmakarov about 3 years ago
vhost-proxy
service to docksal/vhost-proxy:1.7 (multi-arch amd64/arm64 image)cli
service and run-cli
command to docksal/cli:php7.4-3.0
mysql
service to docksal/mysql:5.7-1.5
"version"
property is now optional, this change is fully backwards compatible with the existing 2.1
stack files.dns
, healthchecks
, and logging
settings into x-common-settings
in services.yml
(yaml anchors are now supported!)stack-platformsh.yml
) based on platformsh-templates/drupal9
fin acli
to top level command (using acquia/cli)fin sysinfo
nfsd status
and showmount -e
fin
by sourcing it (source $(which fin)
)services/web
which
with command
in shell function wrappers (pwd
, docker
, docker-compose
) (#1496)docker-machine
wrapper, as microsoft/WSL#4078 is now resolved.fin update
- without this, fin update
would exit with 0
even if there were errors during the update process.CLI_IMAGE
version to a version with XDebug v2 (docksal/cli
v2.12 and below).fin update
busybox
instead of docksal/empty
image in is_docker_path
check (busybox is multi-arch)fin pull
CODEOWNERS
Published by lmakarov almost 4 years ago
COMPOSER_DEFAULT_VERSION
in services.yml
to support Composer version switching instructions in docsfin sysinfo
improvements
DOCKER_HOST
unconditionally (may be helpful in any case)docksal-dns
and docksal-ssh-agent
servicesDOCKSAL_CONTAINER_HEALTHCHECK_INTERVAL
option
Published by lmakarov almost 4 years ago
cli
service to docksal/cli:2.12-php7.3
postgres
service to postgres:10.14-alpine
SSH_AUTH_SOCK_DIR
owner in cases when the volume directory has been already created by docker (root user)ver_to_int
to 4 positions to correctly handle Docker Desktop's a.b.c.d (4 positions) version schemadocker_desktop_version
check on Windows for recent Docksal Desktop versionsDOCKASL_VOLUME=disabled
(DOCKASL_VOLUME=disable
=> DOCKASL_VOLUME=disabled
)fin project create
Published by lmakarov over 4 years ago
0.0.0.0
for vhost-proxy and dns with Docker Desktop 2.2.0.0+ on Mac/Windowsdocksal-dns
is disabled, use DOCKSAL_DNS_UPSTREAM / DOCKSAL_DEFAULT_DNS as primary DNSREQUIREMENTS_DOCKER_DESKTOP
to 2.1.0.5
REQUIREMENTS_DOCKER='19.03.9'
- this is the earliest version available for Ubuntu 20.04 (focal) LTSREQUIREMENTS_DOCKER_DD='19.03.8'
- this is the latest version available with Docker DesktopREQUIREMENTS_DOCKER_B2D='19.03.5'
- this is the final boot2docker versionREQUIREMENTS_DOCKER_DEBIAN
ID_LIKE
in is_debian
(#1377)Published by lmakarov over 4 years ago
vhost-proxy
to docksal/vhost-proxy:1.6
cli
image to docksal/cli:2.11-php7.3
DOCKSAL_DNS_DISABLED
global config switch to allow disabling the build-in docksal-dns
service (#1376)
docksal.site
base domain for projectslisten udp 0.0.0.0:53: bind: address already in use
)fin run-cli
(#1252)fin db cli
(#1263)fin exec
running scripts (#1289)cli
from vhost-proxy
and missing ssh agent socket (#1291)SSH_AUTH_SOCKET
(#1308)DOCKSAL_DNS_DOMAIN
with Docker Desktop 2.2.0.0+
.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.mkcert
(#1370)Published by lmakarov over 4 years ago
If you have ports 53/80/443 in use on your Mac or Windows host, then you would need to either:
DOCKSAL_VERSION=v1.13.2 fin update
) until we find a better way to address upstream regressions with newer Docker Desktop versions.0.0.0.0
by default in virtualized environments (fixes #1268, fixes #1342)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".fin config set --global DOCKSAL_DNS_DOMAIN=docksal.site
Note: This option is enforced with Docker Desktop for Windows 2.2.0.0+Published by lmakarov over 4 years ago
DOCKSAL_VOLUMES
(#1275, #1296)Published by lmakarov almost 5 years ago
IDE_PASSWORD
variable to IDE stack file (#1241)PHP_IDE_CONFIG
variable in services.yml
SSH_AUTH_SOCK
being unset for custom commands (#1248)fin bash
(#1247)user
and shell
labels on cli
in sercvice.yml
ssh_key()
Published by lmakarov almost 5 years ago
cli
to docksal/cli:2.10-php7.3 - PHP 7.3 is now the default version in all PHP stacks
docksal/cli:2.6-php5.6
and docksal/cli:2.6-php7.0
are the last images that included these EOL PHP versionsfin project reset
.cli
docksal/cli
v2.10+http://ide-${VIRTUAL_HOST}
(using dash instead of dot separator in the URL)IDE_ENABLED=1
)DOCKSAL_SSH_AGENT_USE_HOST
variable to control which ssh-agent is used (host vs docksal) (#1080). See variables docs for usage details.fin project create --name=myproject --repo=https://github.com/org/project.git
fin pull
)
drush8
for Acquia pull commands (#1087)provider_pull_acquia_db()
(#1093)fin hosts add
(#766)DRUSH_OPTIONS_URI
to the cli service (#1115)cli
service definition
cli
, they can be assumed from the environment instead of having to hard-code in app codeIMAGE_RUN_CLI
variable which can be used to override the image via the global docksal.env
fin config yml
as a quick way to export static config (#728)DOCKSAL_CONFIRM_YES
variable to allow auto-answering yes to all yes/no confirms (#1186)--quiet
option for fin ssh-key add command (#1179)fin exec
and fin bash
commands using io.docksal.shell
and io.docksal.user
container labels (#1122)osxfs:cached
and named volumes (#1218)DOCKSAL_LOCK_UPDATES=1
now disables checks for updates. Previously, it would check, but not allow an update (#1081)fin init
as a single step to bootstrap a project "from zero to hero"ngrok.yml
config file documentation (#1100)startup.sh
script (#751)fin vm ip
command from documentation and listed the canonical Docksal IPPublished by lmakarov almost 5 years ago
Published by lmakarov almost 5 years ago
See https://github.com/docksal/docksal/pull/1220 for the upcoming release notes
Published by lmakarov over 5 years ago
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
fin exec
that prevented executing a command in an arbitrary container (#1074)xargs
in a cross-platform compatible way in fin cleanup (#1076)fin
command docsPublished by lmakarov over 5 years ago
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
--rm
in a docker run
call in is_docker_path
to cleanup existed containers (#1039, #1064)fin cleanup
DOCKSAL_STACK
definition is incorrect (#1051)fin exec
if target container is not found (#1051)UNISON_USER
and UNISON_GROUP
from volumes-unison.yml
(#1049)
wmic.exe
to get logical drives list on Windows (#1059)fin pull
tests in CIDOCKSAL_ENVIRONMENT
variable use cases (#1041)cli
fin config
docs (#1035)Published by lmakarov over 5 years ago
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
db
service in stacks/services.yml
(use mysql
service instead in custom stacks)stack-pantheon.yml
file to the list of stacks to download during update/install (#1024)fin vm rm
(#1021)