We're hiring! Located in Paris 🇫🇷 and dreaming of being full-time on Strapi? Join us!
API creation made simple, secure and fast.
The most advanced open-source Content Management Framework (headless-CMS) to build powerful API with no effort.
Getting Started
Read the Getting Started tutorial or follow the steps below:
🖐 Requirements
Operating system:
- Ubuntu/Debian
- CentOS/RHEL
- MacOS
- Windows - WSL Only
- Docker - Docker-Repo
Please note that Strapi may work on other Operating Systems, but are not tested at this time.
Node:
- NodeJS >= 10.x
- NPM >= 6.x
Please note that right now Node 11 is not supported, and the current Node LTS (v10) should be used.
Database:
- MongoDB >= 3.x
- MySQL >= 5.6
- MariaDB >= 10.1
- PostgreSQL >= 10
⏳ Installation
npm install strapi@alpha -g
We recommend always using the latest version of Strapi to start your new project. As this project is currently in Alpha, some breaking changes may occur. New releases are shipped every two weeks to fix/enhance the project.
🏗 Create a new project
strapi new my-project
This command will generate a brand new project with the default features (authentication, permissions, content management, content type builder & file upload).
🚀 Start your project
cd my-project
strapi start
Congratulations, you made it! Enjoy 🎉
Try on Heroku
You can also give it a try using Heroku in one click!
Be aware that one of the content type builder won't work due to the writing files restriction on the Heroku servers. If you do want to change content types, you need to follow these steps:
- Click the button above and deploy your app
- Clone that repo by using
heroku git:clone -a
followed by your repo's name - Go into the cloned projects' folder using
cd
followed by your repo's name - Add the Heroku boilerplate as a remote by running
git remote add boilerplate https://github.com/strapi/strapi-heroku-app
- Pull from this new origin by running
git pull boilerplate master
Features
- Modern Admin Panel: Elegant, entirely customizable and fully extensible admin panel.
- Secure by default: Reusable policies, CSRF, CORS, P3P, Xframe, XSS, and more.
- Plugins Oriented: Install auth system, content management, custom plugins, and more, in seconds.
- Blazing Fast: Built on top of Node.js, Strapi delivers amazing performances.
- Front-end Agnostic: Use any front-end frameworks (React, Vue, Angular, etc.), mobile apps or even IoT.
- Powerful CLI: Scaffold projects and APIs on the fly.
- SQL & NoSQL databases: Work with Mongo as a main database, also supports Postgres, MySQL, etc.
Contributing
Please read our Contributing Guide before submitting a Pull Request to the project.
Support
For more information on the upcoming version, please take a look to our ROADMAP.
Community support
For general help using Strapi, please refer to the official Strapi documentation. For additional help, you can use one of this channel to ask question:
- StackOverflow
- Slack (highly recommended for faster support)
- GitHub
- Facebook.
Professional support
Strapi Solutions, the company behind Strapi, provides a full range of solutions to get better results, faster. We're always looking for the next challenge: coaching, consulting, training, customization, etc.
Drop us an email to see how we can help you.
Migration
Follow our migration guides on the wiki to keep your projects up-to-date.
Roadmap
Check out our roadmap to get informed by the latest feature released and the upcoming ones. You can also give us insights and vote for a specific feature.
Sponsors
Become a sponsor and get your logo on our README on GitHub with a link to your site.
License
MIT License Copyright (c) 2015-2019 Strapi Solutions.