Shopsys
  • E-shopy na míru

    • Customized e-shopsE-shopy pro koncové zákazníky. Postavené na objem, výkon v sezónních špičkách a konverzi.
    • Strategie a design
    • Integrace a měření
    • Platforma
    • Pro koho
    • Inovace a vize
  • Showcase
    • BlogNovinky z vývoje platformy a e-shopy, které na ní stojí.
    • Exec magazínOdborný magazín pro e-commerce manažery s obsahem, který jinde nenajdete.
  • Shopsys

    • CompanyKdo jsme a pro koho stavíme.
    • KariéraOtevřené pozice a jak u nás vypadá práce.

    Partnerství

    • PartnersPro agentury a vývojáře, kteří chtějí stavět na Shopsys Platform.
    • Solution PartnersAgentury, se kterými spolupracujeme.

    PR a výsledky

    • Výroční zprávyVýsledky hospodaření za jednotlivé roky.
  • Contact
Get a Quote

How to Install Shopsys Framework

Rostislav Vítek
Product
5. 11. 2018

This article lists all the possible ways of installing Shopsys Framework and provides links to corresponding articles in the documentation that contain step by step instructions. No matter which type of installation you choose, thanks to the detailed guides you will be able to start developing your project on Shopsys Framework in no time.

One of the ultimate goals of Shopsys Framework is good scalability. A long time ago, when we were discussing the future architecture of the framework, we figured that by making the application containerized we would open up the opportunity for lots of scaling possibilities, e.g., a containerized application is well suited for deployment and scaling in cloud solutions like Google Cloud, AWS or Azure. Moreover, when using containers, adding new technology to the application stack is much easier for developers. Even though most of us were Windows users at the time, we decided to make Docker on Linux our default development platform as it is the most natural environment for working with containers.

Local development

Linux & Docker Installation (The recommended way)

As mentioned in the introduction, using Docker on Linux is the recommended way of installing Shopsys Framework. In this environment, development is quick, easy, and straightforward.

For installation instructions, follow the article “Installation Using Docker for Linux” in our documentation.

MacOS & Docker Installation

If you are a MacOS user, you need one extra piece of technology, i.e. Docker-sync tool that enables fast synchronization of the application files between your machine and Docker container.

All installation steps are described in our documentation in the article “Installation Using Docker for MacOS”.

Windows & Docker Installation

For a long time, we were facing huge performance issues when trying to use Docker on Windows. However, after adopting a similar approach to the one we use on MacOS, i.e. leveraging the Docker-sync tool, it is now possible to develop Shopsys Framework projects using Docker on Windows as well. The minimum required Windows version is 10 Pro.

In the “Installation Using Docker for Windows 10 Pro and higher” article in our documentation, you will find all the necessary instructions that will guide you through the process.

Native Installation

Using Docker is really easy and brings lots of advantages to developers. However, if you do not want to use Docker for some reason, there is the possibility to install Shopsys Framework natively. This is the least recommended way as you need to set up each technology (PHP-FPM, Postgres, Elasticsearch, Redis, etc.) manually. Also, as the framework uses microservices, you need to install them separately and run them manually.

All the steps necessary for installing Shopsys Framework natively are described in “Native Installation” article in our documentation.

Continuous Integration and Production Server

Our ultimate goal for production server installation is a usage of Kubernetes for cloud deployment. So far, we have successfully started using Kubernetes for deployment of our application on a continuous integration server. All the configuration steps are described in the cookbook “Continuous Integration Using Kubernetes” in our documentation.

For those who may consider the Kubernetes solution too complex for their projects, our recommendation is to use simple Docker installation with all the data storages installed natively. This approach is described in detail in the article “Installation Using Docker on Production Server”.

Problems and troubleshooting

We are doing our best to provide you with the detailed installation instructions regardless of the solution you choose. Despite this, it is possible you may run into some issues during the installation. In such an event, do not hesitate to ask for help in the #installation channel in our Slack. Also, if you find a problem in any of the guides, we always appreciate our community reporting an issue or creating a pull request on our Github.

Conclusion

The most preferred solution for developing Shopsys Framework projects is using Docker. It provides the easiest way of running the application without the need for setting everything manually. Moreover, we are planning to add new technologies to the technology stack (e.g. RabbitMQ), and this is a really simple task with Docker.

Regarding an operating system, we recommend using Linux as this way you get the best developer experience and a maximum speed of the application on your localhost. However, you can easily use MacOS or Windows 10 Pro and higher as well.

Čtěte také
  • Release highlights 14.0.0
  • Release highlights 13.0.0
  • Introducing the Shopsys Platform: The Solution for E-Shops that Refuse to Compromise
  • Shopsys Framework Release Highlights v7.3.7 LTS
  • Shopsys Framework Release Highlights v9.1.0
18. 11. 2026 Release Highlights 20.0.0
2. 6. 2026 MCP and AI Client Access Now in Shopsys Platform! Ask Your E-shop What You Want to Know
1. 6. 2026 Release Highlights 19.0.0

Get
an Estimate

We will gladly prepare an estimate of your project's time and costs. Please fill out the form below. We will get back to you shortly.

    I take into account that my personal data are processed by Shopsys s.r.o. To get more information read our Privacy policy.
    • Customized e-shops
    • Products
      • Shopsys Platform
      • Shopify Plus
    • Partners
      • Become a Partner
      • Solution Partners
    • Showcase
    • About Us
      • Company
      • For Media
    • Resources
      • Blog
      • Case Studies
      • Ebook
      • EXEC magazine
      • Ecommerce Dictionary
      • Materials For Developers
    • Contact
    Facebook Facebook Twitter Twitter LinkedIn LinkedIn GitHub GitHub Slack Slack
    Get a Quote

    © 2003-2026 Shopsys s.r.o., All rights reserved.
    Privacy Policy | Cookie Settings
    Member of ABUGO Group (Shopsys | Smartsupp | Survio | Reservio )

    Manage Consent
    To provide the best experiences, we use technologies like cookies to store and/or access device information. Consenting to these technologies will allow us to process data such as browsing behavior or unique IDs on this site. Not consenting or withdrawing consent, may adversely affect certain features and functions.
    Necessary Always active
    Necessary cookies are absolutely essential for the website to function properly. These cookies ensure basic functionalities and security features of the website, anonymously.
    Preferences
    The technical storage or access is necessary for the legitimate purpose of storing preferences that are not requested by the subscriber or user.
    Analytics
    The technical storage or access that is used exclusively for statistical purposes. Analytical cookies are used to understand how visitors interact with the website. These cookies help provide information on metrics the number of visitors, bounce rate, traffic source, etc.
    Advertisement
    Advertisement cookies help us provide our visitors with relevant ads and marketing campaigns.
    • Manage options
    • Manage services
    • Manage {vendor_count} vendors
    • Read more about these purposes
    View preferences
    • {title}
    • {title}
    • {title}