import { Box, Button, Code, Group, List, Space, Tabs, TabsValue, Text, Title } from '@mantine/core'; import { Prism } from '@mantine/prism'; import { IconArrowRight, IconBrandDebian, IconBrandDocker, IconInfoSquareRounded, } from '@tabler/icons-react'; import Image from 'next/image'; import { useState } from 'react'; import { OnboardingStepWrapper } from './common-wrapper'; const dockerRunCommand = `docker run \\ --name homarr \\ --restart unless-stopped \\ -p 7575:7575 \\ -v your-path/homarr/configs:/app/data/configs \\ -v your-path/homarr/data:/app/database \\ -v your-path/homarr/icons:/app/public/icons \\ -d ghcr.io/ajnart/homarr:latest`; const dockerComposeCommand = `version: '3' #---------------------------------------------------------------------# # Homarr - A simple, yet powerful dashboard for your server. # #---------------------------------------------------------------------# services: homarr: container_name: homarr image: ghcr.io/ajnart/homarr:latest restart: unless-stopped volumes: - ./homarr/configs:/app/data/configs - ./homarr/data:/app/database - ./homarr/icons:/app/public/icons ports: - '7575:7575'`; const added = { color: 'green', label: '+' }; export const StepUpdatePathMappings = ({ next }: { next: () => void }) => { const [selectedTab, setSelectedTab] = useState("standard_docker"); return ( Update path mappings Homarr has updated the location of the saved data. We detected, that your instance might need an update to function as expected. It is recommended, that you take a backup of your .json configuration file on the file system and copy it, in case something goes wrong. setSelectedTab(tab)} mt="xs"> }> Docker }> Docker Compose }> Standalone Linux / Windows } > Unraid }> Others Back up your configuration. In case you didn't mount your configuration correctly, you could risk loosing your dashboard. To back up, go on your file system and copy the directory, containing your default.json to your local machine. Before you continue, check that you still have the command, that you set up Homarr with. Otherwise, your configuration might not be loaded correctly or icons are missing. Run docker rm homarr, where homarr indicates the name of your container Run docker run ... again, that you used to create the Homarr container. Note, that you need to add a new line: {dockerRunCommand} Refresh this page and click on "continue" Back up your configuration. In case you didn't mount your configuration correctly, you could risk loosing your dashboard. To back up, go on your file system and copy the directory, containing your default.json to your local machine. Navigate to the directory, where the docker-compose.yml for Homarr is located. Run docker compose down Edit docker-compose.yml using text editor. Use Notepad or VSC on GUI based systems. Use nano or vim on terminal systems. {dockerComposeCommand} Run docker compose up. Refresh this page and click on "continue" You're lucky. For installation without Docker on Windows and Linux, there are no additional steps required. However, be advised that your backups should start to include the files located at /database too, if you run automatic backups. Click on your Homarr application and click "Edit" Scroll down and click on the link "Add another path, port, variable or device" After the new modal has opened, make sure that "Path" has been selected at the top In the container path, enter /app/database In the host path, enter a new path on your host system. Choose a similar path, but the innermost directory should be different, than your existing mounting points (eg.{' '} /mnt/user/appdata/homarr/data) Click "Apply" and wait for the container to be restarted. Refresh this page and click on "continue" We are sadly not able to include upgrade guides for all kind of systems. If your system was not listed, you should mount this new mounting point in your container: /app/database {selectedTab ? ( ) : ( Please select your installation method )} ); };