import AdminUrlCookiePath from '/docs/snippets/admin-url-cookie-path.md'

Admin panel customization: Host, port, and path configuration#

Configure the Strapi admin panel's host, port, and URL path in the config/admin.[ts|js] file to change where it is accessible from its default location at /admin.

By default, Strapi's admin panel is exposed via . For security reasons, the host, port, and path can be updated.

Update the admin panel's path only#

Unless you chose to deploy Strapi's back-end server and admin panel server on different servers (see deployment), by default:

• The back-end server and the admin panel server of Strapi both run on the same host and port, which is http://localhost:1337/.
• The admin panel is accessible at the /admin path while the back-end server is accessible at the /api path.

To make the admin panel accessible at another path, for instance at http://localhost:1337/dashboard, define or update the url property in the admin panel configuration file as follows:

module.exports = ({ env }) => ({
  // … other configuration properties
  url: "/dashboard",
});

Since by default the back-end server and the admin panel server run on the same host and port, only updating the config/admin.[ts|js] file should work if you left the host and port property values untouched in the server configuration file, which should be as follows:

module.exports = ({ env }) => ({
  host: env("HOST", "0.0.0.0"),
  port: env.int("PORT", 1337),
});

export default ({ env }) => ({
  host: env("HOST", "0.0.0.0"),
  port: env.int("PORT", 1337),
});

Update the admin panel's host and port#

If the admin panel and the back-end server of Strapi are not hosted on the same server (see deployment), you will need to update the host and port of the admin panel.

This is done in the admin panel configuration file, for example to host the admin panel on my-host.com:3000 properties should be updated follows:

module.exports = ({ env }) => ({
  host: "my-host.com",
  port: 3000,
  // Additionally you can define another path instead of the default /admin one 👇
  // url: '/dashboard' 
});

export default ({ env }) => ({
  host: "my-host.com",
  port: 3000,
  // Additionally you can define another path instead of the default /admin one 👇
  // url: '/dashboard'
});

:::strapi Other admin panel configurations
The /config/admin.[ts|js] file can be used to configure many other aspects. Please refer to the admin panel configuration documentation for details.
:::

:::tip Behind a reverse proxy
When serving the admin from a different public origin (domain, host, or port) than the API, set host/port accordingly and ensure your proxy forwards headers (e.g., X-Forwarded-*). If the admin is reachable at a different origin, prefer configuring that origin explicitly.
:::