# docksal

**Repository Path**: dragonpig/docksal

## Basic Information

- **Project Name**: docksal
- **Description**: Docker powered environments for web development on macOS, Windows and Linux
- **Primary Language**: Shell
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-04-03
- **Last Updated**: 2020-12-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Docksal [![Latest Release](https://img.shields.io/github/release/docksal/docksal.svg?style=flat-square)](https://github.com/docksal/docksal/releases/latest) [![Build Status](https://img.shields.io/travis/docksal/docksal.svg?style=flat-square)](https://travis-ci.org/docksal/docksal)

[![Setup Instructions](https://img.shields.io/badge/%E2%9A%99-%20Setup%20Instructions%20-blue.svg)](https://docs.docksal.io/en/master/getting-started/setup)
[![Gitter](https://img.shields.io/gitter/room/docksal/community-support.svg)](https://gitter.im/docksal/community-support)
[![Docksal Blog](https://img.shields.io/badge/📖-Read%20the%20Blog-orange.svg)](https://blog.docksal.io)

Docker powered environments for web development on macOS, Windows, and Linux.

Running Drupal, Wordpress, Magento, Laravel, Symfony, Backdrop, Grav, Hugo, Gatsby,
and others can be one step away with ready-to-use boilerplates.

```
fin project create
```

Create your [custom automation](https://docs.docksal.io/en/master/fin/custom-commands/) in Bash, PHP or Node
to spin up your project anywhere where Docksal is with a single command, or to automate regular tasks. A unified
environment ensures that your automation will work for everyone in your team.

## Better than VMs

"I love my Vagrant box. Why would I want to switch to a Docker based solution?"  

Containers are just [better than VMs](https://www.youtube.com/watch?v=jev2EW2hzdY): 
smaller, faster, portable, and more efficient across the board.

Unified environment across the team, regardless of the OS.

Unprecedented ability to automate routine tasks, slashing the time to on-board new people.

<a name="setup"></a>
<a name="updates"></a>
<a name="getting-started"></a>
## Getting started

Follow the [Docksal Installation instructions](https://docs.docksal.io/en/master/getting-started/setup) to get started.

Then simply try

```bash
fin project create
```

If you would like to be in more control, check out one of the pre-configured boilerplate projects 
to your local and run `fin init`.

- [Drupal 8](https://github.com/docksal/drupal8)
- [Drupal 7](https://github.com/docksal/drupal7)
- [WordPress](https://github.com/docksal/wordpress)
- [Magento](https://github.com/docksal/magento)
- [Magento with sample content](https://github.com/docksal/magento-demo)
- [Laravel](https://github.com/docksal/example-laravel)
- [Symfony Skeleton](https://github.com/docksal/example-symfony-skeleton)
- [Symfony Web App](https://github.com/docksal/example-symfony-webapp)
- [Grav CMS](https://github.com/docksal/example-grav)
- [Backdrop CMS](https://github.com/docksal/example-backdrop)
- [Hugo](https://github.com/docksal/example-hugo)
- [GatsbyJS](https://github.com/docksal/example-gatsby)


More advanced use cases and tutorials are available in the [Documentation](https://docs.docksal.io/en/master) and on the [Official Blog](http://blog.docksal.io).

## Contributing to Docksal

Ready to give back? Check the [Contributing](CONTRIBUTING.md) docs on how to get involved.  
We have a room on Gitter where questions can be asked and answered 
[![Gitter](https://img.shields.io/gitter/room/docksal/community-support.svg)](https://gitter.im/docksal/community-support)  
If you have experience with Docksal and Docker, please stick around in the room to help others.

## Roadmap

For the list of current and past releases check the [Projects](https://github.com/orgs/docksal/projects) section.  
Change records are published there and in the [Changelog](CHANGELOG.md) docs.