mirror of
				https://github.com/paperless-ngx/paperless-ngx.git
				synced 2025-10-30 03:56:23 -05:00 
			
		
		
		
	Adds a few steps for migration from the LinuxServer.io image
This commit is contained in:
		| @@ -634,6 +634,48 @@ Migration to paperless-ngx is then performed in a few simple steps: | |||||||
| 10.  Optionally, follow the instructions below to migrate your existing data to PostgreSQL. | 10.  Optionally, follow the instructions below to migrate your existing data to PostgreSQL. | ||||||
|  |  | ||||||
|  |  | ||||||
|  | Migrating from LinuxServer.io Docker Image | ||||||
|  | ======================== | ||||||
|  |  | ||||||
|  | As with any upgrades and large changes, it is highly recommended to create a backup before | ||||||
|  | starting.  This assumes the image was running using Docker Compose, but the instructions | ||||||
|  | are translatable to Docker commands as well. | ||||||
|  |  | ||||||
|  | 1.  Stop and remove the paperless container | ||||||
|  | 2.  If using an external database, stop the container | ||||||
|  | 3.  Update Redis configuration | ||||||
|  |  | ||||||
|  |     a)  If ``REDIS_URL`` is already set, change it to ``PAPERLESS_REDIS`` and continue | ||||||
|  |         to step 3. | ||||||
|  |     b)  Otherwise, in the ``docker-compose.yml`` add a new service for Redis, | ||||||
|  |         following `the example compose files <https://github.com/paperless-ngx/paperless-ngx/tree/main/docker/compose>` | ||||||
|  |     b)  Set the environment variable ``PAPERLESS_REDIS`` so it points to the new Redis container | ||||||
|  |  | ||||||
|  | 4.  Update user mapping | ||||||
|  |  | ||||||
|  |     a)  If set, change the environment variable ``PUID`` to ``USERMAP_UID`` | ||||||
|  |     b)  If set, change the environment variable ``PGID`` to ``USERMAP_GID`` | ||||||
|  |  | ||||||
|  | 5.  Update configuration paths | ||||||
|  |  | ||||||
|  |     a) Set the environment variable ``PAPERLESS_DATA_DIR`` | ||||||
|  |        to ``/config`` | ||||||
|  |  | ||||||
|  | 6.  Update media paths | ||||||
|  |  | ||||||
|  |     a) Set the environment variable ``PAPERLESS_MEDIA_ROOT`` | ||||||
|  |        to ``/data`` | ||||||
|  |  | ||||||
|  | 7.  Update timezone | ||||||
|  |  | ||||||
|  |     a) Set the environment variable ``PAPERLESS_TIME_ZONE`` | ||||||
|  |        to the same value as ``TZ`` | ||||||
|  |  | ||||||
|  | 8.  Modify the ``image:`` to point to ``ghcr.io/paperless-ngx/paperless-ngx:latest`` or | ||||||
|  |     a specific version if preferred. | ||||||
|  |  | ||||||
|  | 9.  Start the containers as before, using ``docker-compose``. | ||||||
|  |  | ||||||
| .. _setup-sqlite_to_psql: | .. _setup-sqlite_to_psql: | ||||||
|  |  | ||||||
| Moving data from SQLite to PostgreSQL | Moving data from SQLite to PostgreSQL | ||||||
|   | |||||||
		Reference in New Issue
	
	Block a user
	 Trenton H
					Trenton H