Skip to main content
Prerequisite You should have installed Node.js (version 20.17.0 or higher).
Step 1. Install the Mint CLI:
Step 2. Go to the root of your docs app (where docs.json lives) and run:
The documentation website is now available at http://localhost:3000.

Custom Ports

Mint uses port 3000 by default. You can use the --port flag to customize the port. For example, use this command to run on port 3333:
If the port is already taken, Mint falls back to the next available port:
If you do not want to install the CLI globally, you can also run:

CLI Versions

Each CLI is linked to a specific version of Mintlify. Please update the CLI if your local website looks different than production.

Deployment

Unlimited editors available under the Startup Plan
You should see the following if the deploy successfully went through:

Troubleshooting

Here’s how to solve some common problems when working with the CLI.
Verify that you are on Node.js v20.17.0 or newer. Then run mint update and try mint dev again.
Try navigating to the root of your device and delete the ~/.mintlify folder. Then run mint dev again.
Curious about what changed recently? Check the Mintlify product updates.