These instructions are only applicable to macOS and Windows.
fin vm ram - will show the current memory size
For hosts with limited RAM (less than 8GB) it may be necessary to limit the VM memory to 1GB:
fin vm ram 1024 - will set the VM memory to 1024MB
1GB of RAM provides enough memory to run 2 basic LAMP stacks at the same time.
When working with multiple projects, it is best to limit the number of active projects to 1 or 2. Trying to launch more than 2 at the same time may result in unpredictable issues.
fin stop --all to stop all projects, then
fin project start to restart the one you plan to work with.
Involves removing current VM. Your files will not be deleted, but databases will need to be re-imported, containers’ images will be re-downloaded.
fin vm remove
VBOX_HDD=80000 fin system start
VBOX_HDD is disk size in Megabytes. Default is
There is no good way to automate this.
If you are looking to free up some space that is already used, rather than resizing the virtual disk, then here are some steps that you can take:
fin cleanup is the easiest easiest way to free space. This will clear out any containers of projects that no
longer exists on your computer.
The next step would be to look for old projects that do exist, but you may not be working on. Run
fin project list --all
and look for old, unused projects. You can remove their containers by going to the project directory and running
fin project remove.
You can go even further and delete unused images. Run
fin docker images, investigate the list of images for unused,
outdated or temporary ones, and remove them with
fin docker image remove <name or id>.
Navigating output of the Docker command above might be challenging, so
fin can provide a helping hand.
fin cleanup --images
This command will run a Docker Images cleanup Wizard, that will help you to navigate image list and delete unused one by one. And don’t worry, if the image is still used by an existing container it will not get deleted even if you reply yes.
Removing unused images might be able to free up gigabytes of space.
Was this page helpful?
Thanks for the feedback. If you have a specific, answerable question about how to use Docksal, ask it in Discussions on GitHub. Open an issue if you want to report a problem or suggest an improvement. You can also contribute changes to this page using the link in the top right corner.