It's best to run all `craft` commands through the `nitro` command.
Let’s look back at the project we created in the beginning of the course.
➜ cd ~/training/learnnitro
If I wanted to check if there are any updates to plugins or Craft for this project, I would typically run
➜ craft update/info
I like to do this to get an idea what’s available and then plan my next steps.
But if I run that command, I get a SQL error. Craft checks the database when running Craft commands and based on what I have set in the
.env file for this project, the Craft console command cannot connect to the database. This because internal to the Docker network, the MySQL database server port is 3306. However, externally, it is 3307. I don’t want to change my .env file, so I’ll use the
nitro command instead as a way to run commands as if I was inside the Docker network.
It’s quite simple, really. I just prepend everything with the
nitro command and then run the
craft command as a subcommand.
➜ nitro craft update/info
And that works!
Because of this, I recommend running all
craft commands through the
nitro command, just to be sure you don’t run into any issues.
Here are all of the videos in Local Development with Craft Nitro:
|1||What is Craft Nitro?||Craft Nitro is a Docker-based local hosting solution by Pixel & Tonic, the developers of Craft. It is designed as an officially-supported way to handle local development of Craft CMS website builds, as well as when working on plugin development.||04:08|
|2||Is Craft Nitro Right for Me?||Five checks to see if Craft Nitro is the local development environment for you.||02:33|
|3||How to Install Craft Nitro||Installing Craft Nitro on macOS requires Docker, so that means you need to first have Docker Desktop for Mac installed and working.||09:20|
|4||Creating Your First Site with Nitro||Now that we have Nitro installed, we are ready to create our first Craft hosted with Nitro.||09:49|
|5||Setting Up A Boilerplate Project with Craft Nitro||If you have a boilerplate project that you work with when starting new projects, it’s simple to use that to create a new Nitro project via the `nitro create` command.||04:35|
|6||Migrating an Existing Project to Craft Nitro||Migrating an existing project to Nitro is probably going to be the most common scenario you run into, assuming you move all of your projects over instead of just using Nitro for new projects.||05:04|
|7||Running Craft Commands Against a Craft Nitro Site||It's best to run all `craft` commands through the `nitro` command.||02:15|
|8||Craft CMS Multi-Site with Craft Nitro||Supporting a Craft multi-site installation with Craft Nitro requires using the `nitro alias` command.||04:33|
|9||How to Recall Which Nitro Sites Are Running||I like to be able to get a quick peak and reminds myself of what’s what and if I’ve even set up a project in Nitro yet.||02:58|
|10||Removing a Site from Craft Nitro||Here is how to remove a site from Craft Nitro.||03:05|
|11||Testing Email Sending in Craft Nitro||In addition to the core functionality of local hosting, Craft Nitro also has ancillary services that fill out the total experience of running a Craft site.||05:28|
|12||Updating Craft Nitro||Nitro is an actively maintained project by Pixel & Tonic. You’ll get the best experience with Nitro if you regularly update to get the latest features and improvements.||01:37|
|13||Uninstalling Craft Nitro||If you decide that Nitro isn’t for you or you need to troubleshoot an issue by uninstalling Nitro, then this is how to do it.||02:47|
|Course In-Progress||This course is still being updated with new content. Check back for more!|