> For the complete documentation index, see [llms.txt](https://docs.carto.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.carto.com/carto-self-hosted/carto-self-hosted-legacy.md). # Legacy {% hint style="info" %} This documentation page is specifically tailored for existing users of CARTO Self-Hosted who have already installed the legacy version and now seek guidance on updating or making changes to their existing installation. {% endhint %} ### CARTO Self-hosted Legacy version We call "legacy" to [versions prior to 2023.3.31](https://docs.carto.com/carto-self-hosted/release-notes#previous-releases). Before this version, CARTO Self-hosted was installed on a single virtual machine using docker-compose. Later versions use [Kots](https://kots.io/) to manage [Single VM deployments](/carto-self-hosted/deployment/single-vm-deployment.md) as well as [Orchestrated container deployments](/carto-self-hosted/deployment/kubernetes-kots.md). There is an alternative, [advanced option to use Helm](/carto-self-hosted/deployment/kubernetes-helm.md) for deeper customization and specific setup requirements. {% hint style="warning" %} This section of the documentation refers only to Single VM deployments using the older docker-compose method. {% endhint %} ### **What's new in the latest Self-hosted version** **Check the documentation for the new version** [**here**](/carto-self-hosted/overview.md)**.** * **Simplified Updates:** We've revamped the update process to make it quicker, easier, and more seamless. With fewer steps involved, you can ensure your CARTO Self-hosted instance is always up-to-date with the latest features and security patches. * **Enhanced Maintenance Tools:** Our new version introduces enhanced maintenance tools, empowering you to manage your self-hosted CARTO environment with greater efficiency. From monitoring system health to troubleshooting issues, we've got you covered. * **Introducing the Admin Console:** We're thrilled to announce the launch of the Admin Console, a user-friendly interface where you can effortlessly edit the configuration of your CARTO Self-hosted instance and check the status of your system. The Admin Console provides a centralized hub for managing your self-hosted environment, streamlining administrative tasks, and enhancing your overall experience with CARTO Self-hosted. ### **Migration plan for existing customers** For existing customers currently using the legacy version, we understand the importance of a smooth transition. Rest assured, we are diligently working on a comprehensive migration plan to facilitate the transition to the new version seamlessly. Our goal is to minimize disruptions and ensure a hassle-free upgrade process for all our valued customers. ### **What do you need to do?** 1. **Stay Tuned:** Keep an eye on our documentation and communication channels for updates regarding the migration plan. We will provide detailed instructions and support every step of the way. 2. **Prepare for the Transition:** Start familiarizing yourself with the new version by exploring our updated documentation and resources. This will help you adapt quickly once the migration process begins. 3. **Share Your Feedback:** Your feedback is invaluable to us. If you have any questions, concerns, or suggestions regarding the migration process or the new version, please don't hesitate to reach out to our support team. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.carto.com/carto-self-hosted/carto-self-hosted-legacy.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.