Unified, Docker 🐳 powered web development environments for macOS, Windows, and Linux
MIT License
Bot releases are visible (Hide)
Published by lmakarov over 5 years ago
RELEASE CONTAINS BREAKING CHANGES
There is 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)fin pull
- New set of commands to interact with hosting providersfin run-cli
switched to docksal/cli:2.6-php7.2
db
service in stacks/services.yml
PROJECT_URL
variable and printing it after project start (#716)fin vm start/stop
in favor of fin system start/stop
fin
(e.g. FIN_DEBUG=1 fin <command>
)fin exec
and fin bash
now use sh
by default and only use bash
for cli
and db
(#993, #942)🎉 Thanks to all external contributors who also put their efforts into this release! 🎉
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
fin pull
- New set of commands to interact with hosting providersfin run-cli
switched to docksal/cli:2.6-php7.2
db
service in stacks/services.yml
PROJECT_URL
variable and printing it after project start (#716)fin vm start/stop
in favor of fin system start/stop
fin
(e.g. FIN_DEBUG=1 fin <command>
)fin exec
and fin bash
now use sh
by default and only use bash
for cli
and db
(#993, #942)🎉 Thanks to all external contributors who also put their efforts into this release! 🎉
Published by sean-e-dietrich over 5 years ago
RELEASE CONTAINS BREAKING CHANGES
fin pull
- New set of commands to interact with hosting providersfin run-cli
switched to docksal/cli:2.6-php7.2
db
service in stacks/services.yml
PROJECT_URL
variable and printing it after project start (#716)fin vm start/stop
in favor of fin system start/stop
fin
(e.g. FIN_DEBUG=1 fin <command>
)fin exec
and fin bash
now use sh
by default and only use bash
for cli
and db
(#993, #942)Published by sean-e-dietrich over 5 years ago
RELEASE CONTAINS BREAKING CHANGES
fin pull
- New set of commands to interact with hosting providersfin run-cli
switched to docksal/cli:2.6-php7.2
db
service in stacks/services.yml
PROJECT_URL
variable and printing it after project start (#716)fin vm start/stop
in favor of fin system start/stop
fin
(e.g. FIN_DEBUG=1 fin <command>
)fin exec
and fin bash
now use sh
by default and only use bash
for cli
and db
(#993, #942)Published by lmakarov almost 6 years ago
Published by achekulaev almost 6 years ago
fin update
twice to get VirtualBox automatically updated (macOS and Windows) (#836)ssh-key
- the SSH key management script used by the new fin ssh
set of commandsopenresty/openresty:1.13.6.2-1-alpine
(Alpine 3.8)DEFAULT_CERT
supportmax_input_vars
to 2000
for PHP FPMSECRET_SSH_PRIVATE_KEY
should now be base64 encodedfin ssh-key
- new set of commands to manage SSH keys and ssh-agentDOCKSAL_VOLUMES=none
option
user.email
and user.name
settings from the host to cli
fin sysinfo
output (#783 #784)DEFAULT_CERT
support for vhost-proxy
via the DOCKSAL_VHOST_PROXY_DEFAULT_CERT
global variableSANDBOX_PERMANENT
configuration variable for sandboxeshttp://
in fin vhosts
cli_home
volume when cli
service is removed/reset (#787)db_data
volume when db
service is removed/resetssh-agent
(#773, #774)/etc/resolv.conf
(#782)fin run-cli
and fin bash
(docksal/service-cli#92)nslookup
probe on AlpineSYNC_PREFER=newer
in unison volume settings to prefer most recently updated files (#821)run-cli
because we cannot guarantee that $HOME/.docksal
directory is mapped inside Docker (#771)fin reset
SANDBOX_PERMANENT
and VIRTUAL_HOST_CERT_NAME
Published by lmakarov almost 6 years ago
ssh-key
- the SSH key management script used by the new fin ssh
set of commandsopenresty/openresty:1.13.6.2-1-alpine
(Alpine 3.8)DEFAULT_CERT
supportmax_input_vars
to 2000
for PHP FPMSECRET_SSH_PRIVATE_KEY
should now be base64 encodedfin ssh-key
- new set of commands to manage SSH keys and ssh-agentDOCKSAL_VOLUMES=none
option
user.email
and user.name
settings from the host to cli
fin sysinfo
output (#783 #784)DEFAULT_CERT
support for vhost-proxy
via the DOCKSAL_VHOST_PROXY_DEFAULT_CERT
global variableSANDBOX_PERMANENT
configuration variable for sandboxeshttp://
in fin vhosts
cli_home
volume when cli
service is removed/reset (#787)db_data
volume when db
service is removed/resetssh-agent
(#773, #774)/etc/resolv.conf
(#782)fin run-cli
and fin bash
(docksal/service-cli#92)nslookup
probe on AlpineSYNC_PREFER=newer
in unison volume settings to prefer most recently updated files (#821)run-cli
because we cannot guarantee that $HOME/.docksal
directory is mapped inside Docker (#771)fin reset
SANDBOX_PERMANENT
and VIRTUAL_HOST_CERT_NAME
Published by lmakarov almost 6 years ago
ssh-key
- the SSH key management script used by the new fin ssh
set of commandsopenresty/openresty:1.13.6.2-1-alpine
(Alpine 3.8)DEFAULT_CERT
supportmax_input_vars
to 2000
for PHP FPMSECRET_SSH_PRIVATE_KEY
should now be base64 encodedfin ssh-key
- new set of commands to manage SSH keys and ssh-agentDOCKSAL_VOLUMES=none
option
user.email
and user.name
settings from the host to cli
fin sysinfo
output (#783 #784)DEFAULT_CERT
support for vhost-proxy
via the DOCKSAL_VHOST_PROXY_DEFAULT_CERT
global variableSANDBOX_PERMANENT
configuration variable for sandboxeshttp://
in fin vhosts
cli_home
volume when cli
service is removed/reset (#787)db_data
volume when db
service is removed/resetssh-agent
(#773, #774)/etc/resolv.conf
(#782)fin run-cli
and fin bash
(docksal/service-cli#92)nslookup
probe on AlpineSYNC_PREFER=newer
in unison volume settings to prefer most recently updated files (#821)run-cli
because we cannot guarantee that $HOME/.docksal
directory is mapped inside Docker (#771)fin reset
SANDBOX_PERMANENT
and VIRTUAL_HOST_CERT_NAME
Published by sean-e-dietrich almost 6 years ago
ssh-key
- the SSH key management script used by the new fin ssh
set of commandsopenresty/openresty:1.13.6.2-1-alpine
(Alpine 3.8)DEFAULT_CERT
supportmax_input_vars
to 2000
for PHP FPMSECRET_SSH_PRIVATE_KEY
should now be base64 encodedfin ssh-key
- new set of commands to manage SSH keys and ssh-agentuser.email
and user.name
settings from the host to cli
fin sysinfo
output (#783 #784)DEFAULT_CERT
support for vhost-proxy
via the DOCKSAL_VHOST_PROXY_DEFAULT_CERT
global variableSANDBOX_PERMANENT
configuration variable for sandboxeshttp://
in fin vhosts
cli_home
volume when cli
service is removed/reset (#787)db_data
volume when db
service is removed/resetssh-agent
(#773, #774)/etc/resolv.conf
(#782)fin run-cli
and fin bash
(docksal/service-cli#92)fin reset
SANDBOX_PERMANENT
and VIRTUAL_HOST_CERT_NAME
Published by lmakarov almost 6 years ago
ssh-key
- the SSH key management script used by the new fin ssh
set of commandsopenresty/openresty:1.13.6.2-1-alpine
(Alpine 3.8)DEFAULT_CERT
supportmax_input_vars
to 2000
for PHP FPMSECRET_SSH_PRIVATE_KEY
should now be base64 encodedfin ssh-key
- new set of commands to manage SSH keys and ssh-agentuser.email
and user.name
settings from the host to cli
fin sysinfo
output (#783 #784)DEFAULT_CERT
support for vhost-proxy
via the DOCKSAL_VHOST_PROXY_DEFAULT_CERT
global variableSANDBOX_PERMANENT
configuration variable for sandboxeshttp://
in fin vhosts
cli_home
volume when cli
service is removed/reset (#787)db_data
volume when db
service is removed/resetssh-agent
(#773, #774)/etc/resolv.conf
(#782)fin run-cli
and fin bash
(docksal/service-cli#92)fin reset
SANDBOX_PERMANENT
and VIRTUAL_HOST_CERT_NAME
Published by achekulaev about 6 years ago
Some sneaky pests 🦂have escaped our underground bug confinement facility and went wild 🦖. Thanks to our dedicated community that immediately spotted those creatures, a special Pest Escape Withholding team (PEW) was dispatched and exterminated the threat on the spot.
Published by lmakarov about 6 years ago
vhost-proxy
to docksal/vhost-proxy:1.3.
cli
to docksal/cli:2.4-php-7.1.
fin config set --global DOCKSAL_USE_RC=1
(#719)fin platform
- run Platform.sh cli in cli
fin composer
- run composer in cli
fin project erase
command - removes containers and erases project files on the hostfin db truncate
- truncate a database (defaults to the default
)fin init
- a default placeholder command when there is no project level init
command definedfin config
now accepts the --env=<environment>
flag, e.g., fin config set --env=local IDE_ENABLED=1
(#584)fin exec
now accept the --in=<service>
, e.g., fin exec --in=db mysql -uroot -p
flag (#609)fin project create
now accepts --name
, --choice
and --yes
options and can be run unattendedfin share
fin share
arguments (#601)fin share
(#611)exec_target = run-cli
can be used in custom commands and addons to run them in a standalone run-cli session (#715)vm
command when running on Linuxuuidgen
as a dependency (#630)fin run-cli
now uses SSH keys from the ssh-agent
servicefin help
fin share
when no parameters are provideddocker
and docker-compose
in fin help
fin
not correctly waited for unison during fin up
vhost-proxy
servicefin config get/set/rm
did not work with an alias (#670)fin vhosts
spitting out nginx config linesdb_data
volume for MySQL/PostreSQL, so its easier to identify them in the docker volume ls
listcli_home
volume for /home/docker
in cli
, so its easier to identify them in the docker volume ls
listSECRET_
to hide the keys in fin config
outputbash -l
)
bash -l
sources ~/.profile
inside cli (for both interactive and non-interactive sessions)docksal/bats
with an interactive tests mode support for automated tests (#705)overrides-osxfs.yml
only for bind volumes (#709)cli
parse_params
to be more robust when invalid parameters are fed in (#735)DOCKER_HOST
on WSLfin sysinfo
fin diagnose
now includes information from fin sysinfo
and should be used to provide diagnostic information when submitting issues on Github (#627)CRLF
line endings detection (#639)git
as a dependency in fin project create
(#635)fin run-cli
run in /root
on PWD (#661)fin exec
behaving differently and failing when passing an existing script as an argument (#720)fin phpcs
sample command to include DrupalPractice
standard (#724)fin run-cli
to make it behave the same way as fin exec
(#738)fin project create
Published by lmakarov about 6 years ago
Set DOCKSAL_USE_RC=1
variable, and run fin update
vhost-proxy
to docksal/vhost-proxy:1.3.
cli
to docksal/cli:2.4-php-7.1.
fin config set --global DOCKSAL_USE_RC=1
(#719)fin platform
- run Platform.sh cli in cli
fin composer
- run composer in cli
fin project erase
command - removes containers and erases project files on the hostfin db truncate
- truncate a database (defaults to the default
)fin init
- a default placeholder command when there is no project level init
command definedfin config
now accepts the --env=<environment>
flag, e.g., fin config set --env=local IDE_ENABLED=1
(#584)fin exec
now accept the --in=<service>
, e.g., fin exec --in=db mysql -uroot -p
flag (#609)fin project create
now accepts --name
, --choice
and --yes
options and can be run unattendedfin share
fin share
arguments (#601)fin share
(#611)exec_target = run-cli
can be used in custom commands and addons to run them in a standalone run-cli session (#715)vm
command when running on Linuxuuidgen
as a dependency (#630)fin run-cli
now uses SSH keys from the ssh-agent
servicefin help
fin share
when no parameters are provideddocker
and docker-compose
in fin help
fin
not correctly waited for unison during fin up
vhost-poroxy
servicefin config get/set/rm
did not work with an alias (#670)fin vhosts
spitting out nginx config linesdb_data
volume for MySQL/PostreSQL, so its easier to identify them in the docker volume ls
listcli_home
volume for /home/docker
in cli
, so its easier to identify them in the docker volume ls
listSECRET_
to hide the keys in fin config
outputbash -l
)
bash -l
sources ~/.profile
inside cli (for both interactive and non-interactive sessions)docksal/bats
with an interactive tests mode support for automated tests (#705)overrides-osxfs.yml
only for bind volumes (#709)cli
parse_params
to be more robust when invalid parameters are fed in (#735)DOCKER_HOST
on WSLfin sysinfo
fin diagnose
now includes information from fin sysinfo
and should be used to provide diagnostic information when submitting issues on Github (#627)CRLF
line endings detection (#639)git
as a dependency in fin project create
(#635)fin run-cli
run in /root
on PWD (#661)fin exec
behaving differently and failing when passing an existing script as an argument (#720)fin phpcs
sample command to include DrupalPractice
standard (#724)fin run-cli
to make it behave the same way as fin exec
(#738)fin project create
Published by sean-e-dietrich about 6 years ago
Set DOCKSAL_USE_RC=1
variable, and run fin update
cli
to get automatically get updates when merged into develop branch.docksal/cli
to v2.3
SECRET_
project erase
featurefin db truncate
commandfin init
if no init
command is detectedvm
command when running on Linuxuuidgen
as a dependencyrun-cli
command to mount ssh-agentproject create
to bypass questions and speed upfin sysinfo
share
when no parameters are being usedfin docker
fin docker-compose
Published by lmakarov over 6 years ago
fin db create
fin cleanup
(triggered during updates) (#582)
Published by lmakarov over 6 years ago
cli
to docksal/cli:2.2-php-7.1.fin reset
(Read more)fin config set IDE_ENABLED=1 && fin project reset cli
in your project folder to enable Cloud9 IDE.http://ide.<VIRTUAL_HOST>
fin config [get|set|remove]
.docksal/docksal.env
) and global ($HOME/docksal/docksal.env
) Docksal variables.fin help config
for details.fin share
to allow for custom ngrok configuration (see Additional ngrok configuration).fin config generate
to allow for DOCKSAL_STACK
and DOCROOT
to be set at runtime.
fin help config
for details.fin run-cli
:
fin run-cli
to use docksal/cli:2.2-php7.1
.run-cli
container at run time or through $HOME/.docksal/docksal.env
file.SECRET_*
variables) are now passed to the run-cli
container./home/docker
as a volume (same as in the default stack).fin help run-cli
for more details$HOME
directory in the run-cli
container by default.--image=...
, --debug
)fin project create
command screen to separate out different frameworks and languages.fin ssh-add
command to allow for non-standard ssh keys to be add automatically (see Automatically add keys).fin help
to reference commands within folders.docksal/unison
image.bg-sync
to unison
in fin
and in stacks/volumes-unison.yml
.fin stop --all
to stop all Docksal projects not all existing Docker containers.fin db create
failing if database exists and fin db drop
failing if database did not exist.blackfire
service configuration to services.yml
and updated Blackfire documentation.fin system stop
network settings introduced by Docksal will now be reverted.fin exec
and fin run-cli
).fin help
topics.fin config set
command.fin share
) integration instructions with the new configuration options.Published by lmakarov over 6 years ago
cli
to docksal/cli:2.1-php7.1
db
to docksal/db:1.2-mysql-5.6
cli
SECRET_SSH_PRIVATE_KEY
, SECRET_ACAPI_EMAIL
, SECRET_ACAPI_KEY
, SECRET_TERMINUS_TOKEN
SECRET_
fin config
output to protect sensitive datadocksal.env
file ($HOME/.docksal.env
) or the project one(s)docksal/cli
v2.1.0+
fin terminus
docksal/cli
v2.1.0+
services.yml
(#193)fin debug
with project configuration loading
fin debug -c ...
, fin debug --load-configuration ...
fin drush
and fin drupal
when run with empty arguments
fin alias
creation command to also update aliases
fin run-cli
(fin rc
) to use docksal/cli:2.1-php7.1
(#483)db
to mysql
in services.yml
db
service definition for backward compatibilityPublished by lmakarov over 6 years ago
vhost-proxy
upgraded to v1.2.0
256k
- fixes 500 errors for some Drupal 8 sites sending huge HTTP headersdocksal/cli:2.0-php7.1
(PHP 7.1) by default
1.1-varnish5
(Varnish 5) imagefin system
subset of commands (#387)
fin system stop
- removes Docksal system services and stops all Docksal projects (fin stop --all
)default-nodb
stack - when you don't need MySQL (#427)node
stack and sample project
fin cleanup
refactoring
prune
commands where it makes sensefin db create
now uses utf8mb4
/utf8mb4_unicode_ci
charset/collation by default (#437)fin config generate
now uses DOCKSAL_STACK=default
(instead of a full blown stack-default-static.yml
definition) (#433)stack-acquia-static.yml
and stack-default-static.yml
)fin stop -a
when no projects are running (#450)fin
was not able to use Unison volumes with Docker for Macdocksal.yml
(#459)
docksal.yml
path to detect docker-compose context directorydocksal.yml
now becomes required, so we create it automatically if it does not existdocksal.env
is also created automatically (if not present) to have both configs around for users to useDOCKER_RUNNING
was not always exportedwinpty
on windows (since the experimental Docksal bash shell is deprecated) (#457)FIN_SET_UID
variablesdocksal.env
project_root
in varnish
and solr
services to give access to the project codebase and load custom configuration overrides (see respective docs for details)solr
service
io.docksal.virtual-port
label supported introduced in docksal/vhost-proxy:1.2
http://sorl.<VIRTUAL_HOST>/solr
mailhog
service
io.docksal.virtual-port
label supported introduced in docksal/vhost-proxy:1.2
http://mail.<VIRTUAL_HOST>
80
and thus the user: root
override (necessary to bind to privileged ports). This is no longer necessary with vhost-proxy v1.2+ supporting custom port routing.CI=true
is set in in $HOME/.docksal/docksal.env
, vhost-proxy will be open to the world (bind to 0.0.0.0
). This should be used in CI/Sandbox environments.VIRTUAL_HOST
variable to cli
by default, so that it can be used in scripts that run inside cli
DOCKER_HOST
can now be overridden via $HOME/.docksal/docksal.env
(#452)fin share
(fin share --host=example.com
) (#363)fin system
subset of commandsmemcached
and varnish
to keep instructions simpler. Using the extends
approach in yml should be the mainstream.Published by lmakarov almost 7 years ago
IMPORTANT NOTE: if you use VirtualBox you may have to run fin update
twice for this release.
This release addresses a critical issue in 1.6.0, which breaks new Docksal installations on Mac/Windows using VirtualBox mode. We are also introducing support for WSL on Windows (in beta).
fin logs unison
- show Unison logCheck for docker-machine
binary existence during vm stop on update (#422)
Fixed xdebug configuration regression (#420)
Docker for Mac, Unison volumes: Added ability to wait for the initial sync to complete.
Added ability to lock Docksal updates
Set DOCKSAL_LOCK_UPDATES
to anything in $HOME/.docksal/docksal.env
to lock updates. Useful on CI/sandbox servers.
Published by lmakarov almost 7 years ago
IMPORTANT NOTE: if you use VirtualBox run fin update
twice for this release.
From now on the default way to launch commands against projects is via fin project
command subset.
E.g. fin project start
(fin p start
), fin project stop
, fin project reset
etc.
Old fin start
, fin stop
etc. aliases will still work for compatibility, but are removed from the documentation.
Enable osxfs caching automatically with Docker for Mac to improve read performance. (#249, #397)
You can add environment dependent ENV and YML files based on $DOCKSAL_ENVIRONMENT
variable, e.g. docksal-myenv.yml
,
that would only apply, if DOCKSAL_ENVIRONMENT=myenv
(#383, #354). Official documentation is pending.
Grav project creation wizard
Gatsby JS project creation wizard
Laravel project creation wizard
Address DNS issue of corporate networks and VPN
Added backup upstream DNS server for docksal-dns. This addresses cases when DOCKSAL_DNS_UPSTREAM
is set to an internal IP (VPN/LAN) and becomes inaccessible when user disconnects from that network. 8.8.4.4
will now be used as a backup when DOCKSAL_DNS_UPSTREAM is not reachable.
Expose ngrok Web UI on a random port to make it accessible from the host (#379)
Project images are auto-updated during overall update
New vhosts
command to show all registered Docksal virtual hosts
Show virtual host name after project start
Docker for Mac/Win networking setup is now aligned with the VirtualBox mode and Linux:
192.168.64.1 - host IP
192.168.64.100 - Docksal IP
Allow installing Docksal addons from a non-default GitHub repo
Allow any exec_target
for addons and custom commands (#356).
Requires that container specified as exec_target
has project_root
volume defined, just like cli:
volumes:
# Project root volume
- project_root:/var/www:rw,nocopy
fin db create
(#351, #371, #372)fin update
twice. (#280)dns
, vhost-proxy
, ssh-agent
) are running and restart them otherwiseDOCKSAL_DNS_DOMAIN
variable value for default VIRTUAL_HOST
(#390)~/.ssh
exists. This prevents errors for users with no ssh keysifupdown
and resolvconf
if they are missing (#321)overlay2
storage driver (defaut in Docker for Mac/Win and Ubuntu 17.04+) by adding /home/docker
volume in cli
(#325)