Skip to main content
Skip to main content

Admin Dashboard Quickstart

This document will guide you through setting up the admin dashboard in the Medusa backend.

Overview

The admin dashboard is installed on the Medusa backend. The admin dashboard starts when you start the Medusa backend. This also means you can later deploy the Medusa backend along with the admin dashboard on the same hosting.

This guide will explain the steps and configurations required to set up the admin dashboard.


Prerequisites

Medusa Backend

As the admin dashboard is a plugin installed on the Medusa Backend, you must have a Medusa Backend installed first. You can learn how to install it in this documentation.

Node.js

The Admin uses Vite v4.1.4 which requires v14.8+ or v16+ of Node.js, and as Medusa requires v16 or greater it's recommended you use v16+ of Node.js.

You can check which version of Node you have by running the following command:

node -v

You can install Node from the official website.


Install and Serve Admin with the Backend

This section explains how to install the admin to be served with the Medusa Backend and later deployed together.

Step 1: Install the Package

In the directory of your Medusa backend, run the following command to install admin dashboard:

npm install @medusajs/admin

Step 2: Add Admin to Medusa Configurations

In medusa-config.js, add the admin plugin into the array of plugins:

medusa-config.js
const plugins = [
// ...
{
resolve: "@medusajs/admin",
/** @type {import('@medusajs/admin').PluginOptions} */
options: {
// ...
},
},
]

Check this documentation for a full list of available options.

Step 3: Test the Admin Dashboard

You can test the admin dashboard by running the following command in the directory of the Medusa backend:

npx medusa develop

This starts the Medusa Backend and the admin dashboard in a development environment. By default, the admin will be available on the URL localhost:7001 and the browser will open automatically to the admin dashboard in your default browser, unless you have the develop.open option disabled.

Did you set up the admin successfully?

Production Path

Note

This doesn't apply if you have the serve option disabled or you're deploying the admin separately.

When you run the Medusa project in a production environment (such as with the npx medusa start command), the admin dashboard will be available at <MEDUSA_URL>/<ADMIN_PATH>, where:

  1. <MEDUSA_URL> is the URL of your Medusa backend. By default, it'll be localhost:9000 locally.
  2. <ADMIN_PATH> is the path you define in the admin plugin's configurations.

So, if you simulate a production environment locally, the admin dashboard will run by default on localhost:9000/app.


Demo Credentials

If you installed the demo data when you installed the Medusa backend by running:

npm run seed

You can use the email admin@medusa-test.com and password supersecret to log in.

Info

Passwords in Medusa are hashed using the scrypt-kdf. The password hash is then stored in the database.


Create a New Admin User

To create a new admin user from the command line, run the following command in the directory holding your Medusa backend:

npx medusa user -e some@email.com -p some-password

This will create a new user that you can use to log into your admin panel.


Admin User Guide

The admin dashboard provides a lot of ecommerce features including managing Return Merchandise Authorization (RMA) flows, store settings, products, orders, and much more.

You can learn more about the admin dashboard and its features in the User Guide.


Multi-Language Support

Medusa supports multiple languages and translations. Check out available languages here.

Refer to this user guide to learn how to switch the language of the Medusa Admin.


Troubleshooting Installation

Signing into Admin
CORS Errors

See Also

Was this section helpful?