paradizelost/paperless-ngx
1
0
Fork 0
mirror of https://github.com/paperless-ngx/paperless-ngx.git synced 2025-04-02 13:45:10 -05:00
Code Issues Packages Projects Releases Wiki Activity

Documentation: Update documentation to refer only to Docker Compose v2 command (#4650)

Browse Source 
* Replaces references to docker-compose (the v1 executable) with docker compose (the v2 plugin) as well as fixing up some referenes between the tool vs the command

* Update docs/setup.md

Co-authored-by: shamoon <4887959+shamoon@users.noreply.github.com>

* Replaces references to docker-compose (the v1 executable) with docker compose (the v2 plugin) as well as fixing up some referenes between the tool vs the command

---------

Co-authored-by: shamoon <4887959+shamoon@users.noreply.github.com>
This commit is contained in:
Trenton H 2023-11-20 20:14:33 -08:00 committed by GitHub
parent 0eb17e7102
commit c8ee35692c
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
16 changed files with 85 additions and 87 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
README.md
View File

@ -45,9 +45,9 @@ A full list of [features](https://docs.paperless-ngx.com/#features) and [screens
# Getting started # Getting started
The easiest way to deploy paperless is docker-compose. The files in the [`/docker/compose` directory](https://github.com/paperless-ngx/paperless-ngx/tree/main/docker/compose) are configured to pull the image from GitHub Packages. The easiest way to deploy paperless is `docker compose`. The files in the [`/docker/compose` directory](https://github.com/paperless-ngx/paperless-ngx/tree/main/docker/compose) are configured to pull the image from GitHub Packages.
If you'd like to jump right in, you can configure a docker-compose environment with our install script: If you'd like to jump right in, you can configure a `docker compose` environment with our install script:
```bash ```bash
bash -c "$(curl -L https://raw.githubusercontent.com/paperless-ngx/paperless-ngx/main/install-paperless-ngx.sh)" bash -c "$(curl -L https://raw.githubusercontent.com/paperless-ngx/paperless-ngx/main/install-paperless-ngx.sh)"

2
docker/compose/docker-compose.ci-test.yml
View File

@ -1,4 +1,4 @@
# docker-compose file for running paperless testing with actual gotenberg # Docker Compose file for running paperless testing with actual gotenberg
# and Tika containers for a more end to end test of the Tika related functionality # and Tika containers for a more end to end test of the Tika related functionality
# Can be used locally or by the CI to start the nessecary containers with the # Can be used locally or by the CI to start the nessecary containers with the
# correct networking for the tests # correct networking for the tests

10
docker/compose/docker-compose.mariadb-tika.yml
View File

@ -1,4 +1,4 @@
# docker-compose file for running paperless from the Docker Hub. # docker compose file for running paperless from the Docker Hub.
# This file contains everything paperless needs to run. # This file contains everything paperless needs to run.
# Paperless supports amd64, arm and arm64 hardware. # Paperless supports amd64, arm and arm64 hardware.
# #
@ -10,7 +10,7 @@
# as this file and mounted to the correct folders inside the container. # as this file and mounted to the correct folders inside the container.
# - Paperless listens on port 8000. # - Paperless listens on port 8000.
# #
# In addition to that, this docker-compose file adds the following optional # In addition to that, this Docker Compose file adds the following optional
# configurations: # configurations:
# #
# - Instead of SQLite (default), MariaDB is used as the database server. # - Instead of SQLite (default), MariaDB is used as the database server.
@ -23,9 +23,9 @@
# #
# - Copy this file as 'docker-compose.yml' and the files 'docker-compose.env' # - Copy this file as 'docker-compose.yml' and the files 'docker-compose.env'
# and '.env' into a folder. # and '.env' into a folder.
# - Run 'docker-compose pull'. # - Run 'docker compose pull'.
# - Run 'docker-compose run --rm webserver createsuperuser' to create a user. # - Run 'docker compose run --rm webserver createsuperuser' to create a user.
# - Run 'docker-compose up -d'. # - Run 'docker compose up -d'.
# #
# For more extensive installation and update instructions, refer to the # For more extensive installation and update instructions, refer to the
# documentation. # documentation.

10
docker/compose/docker-compose.mariadb.yml
View File

@ -1,4 +1,4 @@
# docker-compose file for running paperless from the Docker Hub. # Docker Compose file for running paperless from the Docker Hub.
# This file contains everything paperless needs to run. # This file contains everything paperless needs to run.
# Paperless supports amd64, arm and arm64 hardware. # Paperless supports amd64, arm and arm64 hardware.
# #
@ -10,7 +10,7 @@
# as this file and mounted to the correct folders inside the container. # as this file and mounted to the correct folders inside the container.
# - Paperless listens on port 8000. # - Paperless listens on port 8000.
# #
# In addition to that, this docker-compose file adds the following optional # In addition to that, this Docker Compose file adds the following optional
# configurations: # configurations:
# #
# - Instead of SQLite (default), MariaDB is used as the database server. # - Instead of SQLite (default), MariaDB is used as the database server.
@ -19,9 +19,9 @@
# #
# - Copy this file as 'docker-compose.yml' and the files 'docker-compose.env' # - Copy this file as 'docker-compose.yml' and the files 'docker-compose.env'
# and '.env' into a folder. # and '.env' into a folder.
# - Run 'docker-compose pull'. # - Run 'docker compose pull'.
# - Run 'docker-compose run --rm webserver createsuperuser' to create a user. # - Run 'docker compose run --rm webserver createsuperuser' to create a user.
# - Run 'docker-compose up -d'. # - Run 'docker compose up -d'.
# #
# For more extensive installation and update instructions, refer to the # For more extensive installation and update instructions, refer to the
# documentation. # documentation.

4
docker/compose/docker-compose.portainer.yml
View File

@ -1,4 +1,4 @@
# docker-compose file for running paperless from the Docker Hub. # Docker Compose file for running paperless from the Docker Hub.
# This file contains everything paperless needs to run. # This file contains everything paperless needs to run.
# Paperless supports amd64, arm and arm64 hardware. # Paperless supports amd64, arm and arm64 hardware.
# #
@ -10,7 +10,7 @@
# as this file and mounted to the correct folders inside the container. # as this file and mounted to the correct folders inside the container.
# - Paperless listens on port 8010. # - Paperless listens on port 8010.
# #
# In addition to that, this docker-compose file adds the following optional # In addition to that, this Docker Compose file adds the following optional
# configurations: # configurations:
# #
# - Instead of SQLite (default), PostgreSQL is used as the database server. # - Instead of SQLite (default), PostgreSQL is used as the database server.

10
docker/compose/docker-compose.postgres-tika.yml
View File

@ -1,4 +1,4 @@
# docker-compose file for running paperless from the docker container registry. # Docker Compose file for running paperless from the docker container registry.
# This file contains everything paperless needs to run. # This file contains everything paperless needs to run.
# Paperless supports amd64, arm and arm64 hardware. # Paperless supports amd64, arm and arm64 hardware.
# #
@ -10,7 +10,7 @@
# as this file and mounted to the correct folders inside the container. # as this file and mounted to the correct folders inside the container.
# - Paperless listens on port 8000. # - Paperless listens on port 8000.
# #
# In addition to that, this docker-compose file adds the following optional # In addition to that, this Docker Compose file adds the following optional
# configurations: # configurations:
# #
# - Instead of SQLite (default), PostgreSQL is used as the database server. # - Instead of SQLite (default), PostgreSQL is used as the database server.
@ -23,9 +23,9 @@
# #
# - Copy this file as 'docker-compose.yml' and the files 'docker-compose.env' # - Copy this file as 'docker-compose.yml' and the files 'docker-compose.env'
# and '.env' into a folder. # and '.env' into a folder.
# - Run 'docker-compose pull'. # - Run 'docker compose pull'.
# - Run 'docker-compose run --rm webserver createsuperuser' to create a user. # - Run 'docker compose run --rm webserver createsuperuser' to create a user.
# - Run 'docker-compose up -d'. # - Run 'docker compose up -d'.
# #
# For more extensive installation and update instructions, refer to the # For more extensive installation and update instructions, refer to the
# documentation. # documentation.

10
docker/compose/docker-compose.postgres.yml
View File

@ -1,4 +1,4 @@
# docker-compose file for running paperless from the Docker Hub. # Docker Compose file for running paperless from the Docker Hub.
# This file contains everything paperless needs to run. # This file contains everything paperless needs to run.
# Paperless supports amd64, arm and arm64 hardware. # Paperless supports amd64, arm and arm64 hardware.
# #
@ -10,7 +10,7 @@
# as this file and mounted to the correct folders inside the container. # as this file and mounted to the correct folders inside the container.
# - Paperless listens on port 8000. # - Paperless listens on port 8000.
# #
# In addition to that, this docker-compose file adds the following optional # In addition to that, this Docker Compose file adds the following optional
# configurations: # configurations:
# #
# - Instead of SQLite (default), PostgreSQL is used as the database server. # - Instead of SQLite (default), PostgreSQL is used as the database server.
@ -19,9 +19,9 @@
# #
# - Copy this file as 'docker-compose.yml' and the files 'docker-compose.env' # - Copy this file as 'docker-compose.yml' and the files 'docker-compose.env'
# and '.env' into a folder. # and '.env' into a folder.
# - Run 'docker-compose pull'. # - Run 'docker compose pull'.
# - Run 'docker-compose run --rm webserver createsuperuser' to create a user. # - Run 'docker compose run --rm webserver createsuperuser' to create a user.
# - Run 'docker-compose up -d'. # - Run 'docker compose up -d'.
# #
# For more extensive installation and update instructions, refer to the # For more extensive installation and update instructions, refer to the
# documentation. # documentation.

10
docker/compose/docker-compose.sqlite-tika.yml
View File

@ -1,4 +1,4 @@
# docker-compose file for running paperless from the docker container registry. # Docker Compose file for running paperless from the docker container registry.
# This file contains everything paperless needs to run. # This file contains everything paperless needs to run.
# Paperless supports amd64, arm and arm64 hardware. # Paperless supports amd64, arm and arm64 hardware.
# All compose files of paperless configure paperless in the following way: # All compose files of paperless configure paperless in the following way:
@ -11,7 +11,7 @@
# #
# SQLite is used as the database. The SQLite file is stored in the data volume. # SQLite is used as the database. The SQLite file is stored in the data volume.
# #
# In addition to that, this docker-compose file adds the following optional # In addition to that, this Docker Compose file adds the following optional
# configurations: # configurations:
# #
# - Apache Tika and Gotenberg servers are started with paperless and paperless # - Apache Tika and Gotenberg servers are started with paperless and paperless
@ -23,9 +23,9 @@
# #
# - Copy this file as 'docker-compose.yml' and the files 'docker-compose.env' # - Copy this file as 'docker-compose.yml' and the files 'docker-compose.env'
# and '.env' into a folder. # and '.env' into a folder.
# - Run 'docker-compose pull'. # - Run 'docker compose pull'.
# - Run 'docker-compose run --rm webserver createsuperuser' to create a user. # - Run 'docker compose run --rm webserver createsuperuser' to create a user.
# - Run 'docker-compose up -d'. # - Run 'docker compose up -d'.
# #
# For more extensive installation and update instructions, refer to the # For more extensive installation and update instructions, refer to the
# documentation. # documentation.

8
docker/compose/docker-compose.sqlite.yml
View File

@ -1,4 +1,4 @@
# docker-compose file for running paperless from the Docker Hub. # Docker Compose file for running paperless from the Docker Hub.
# This file contains everything paperless needs to run. # This file contains everything paperless needs to run.
# Paperless supports amd64, arm and arm64 hardware. # Paperless supports amd64, arm and arm64 hardware.
# #
@ -16,9 +16,9 @@
# #
# - Copy this file as 'docker-compose.yml' and the files 'docker-compose.env' # - Copy this file as 'docker-compose.yml' and the files 'docker-compose.env'
# and '.env' into a folder. # and '.env' into a folder.
# - Run 'docker-compose pull'. # - Run 'docker compose pull'.
# - Run 'docker-compose run --rm webserver createsuperuser' to create a user. # - Run 'docker compose run --rm webserver createsuperuser' to create a user.
# - Run 'docker-compose up -d'. # - Run 'docker compose up -d'.
# #
# For more extensive installation and update instructions, refer to the # For more extensive installation and update instructions, refer to the
# documentation. # documentation.

22
docs/administration.md
View File

@ -71,7 +71,7 @@ First of all, ensure that paperless is stopped.
```shell-session ```shell-session
$ cd /path/to/paperless $ cd /path/to/paperless
$ docker-compose down $ docker compose down
``` ```
After that, [make a backup](#backup). After that, [make a backup](#backup).
@ -79,22 +79,22 @@ After that, [make a backup](#backup).
1. If you pull the image from the docker hub, all you need to do is: 1. If you pull the image from the docker hub, all you need to do is:
```shell-session ```shell-session
$ docker-compose pull $ docker compose pull
$ docker-compose up $ docker compose up
``` ```
The docker-compose files refer to the `latest` version, which is The Docker Compose files refer to the `latest` version, which is
always the latest stable release. always the latest stable release.
1. If you built the image yourself, do the following: 1. If you built the image yourself, do the following:
```shell-session ```shell-session
$ git pull $ git pull
$ docker-compose build $ docker compose build
$ docker-compose up $ docker compose up
``` ```
Running `docker-compose up` will also apply any new database migrations. Running `docker compose up` will also apply any new database migrations.
If you see everything working, press CTRL+C once to gracefully stop If you see everything working, press CTRL+C once to gracefully stop
paperless. Then you can start paperless-ngx with `-d` to have it run in paperless. Then you can start paperless-ngx with `-d` to have it run in
the background. the background.
@ -102,7 +102,7 @@ the background.
!!! note !!! note
In version 0.9.14, the update process was changed. In 0.9.13 and In version 0.9.14, the update process was changed. In 0.9.13 and
earlier, the docker-compose files specified exact versions and pull earlier, the Docker Compose files specified exact versions and pull
won't automatically update to newer versions. In order to enable won't automatically update to newer versions. In order to enable
updates as described above, either get the new `docker-compose.yml` updates as described above, either get the new `docker-compose.yml`
file from file from
@ -220,11 +220,11 @@ Paperless comes with some management commands that perform various
maintenance tasks on your paperless instance. You can invoke these maintenance tasks on your paperless instance. You can invoke these
commands in the following way: commands in the following way:
With docker-compose, while paperless is running: With Docker Compose, while paperless is running:
```shell-session ```shell-session
$ cd /path/to/paperless $ cd /path/to/paperless
$ docker-compose exec webserver <command> <arguments> $ docker compose exec webserver <command> <arguments>
``` ```
With docker, while paperless is running: With docker, while paperless is running:
@ -254,7 +254,7 @@ migration to another DMS.
If you use the document exporter within a cronjob to backup your data If you use the document exporter within a cronjob to backup your data
you might use the `-T` flag behind exec to suppress "The input device you might use the `-T` flag behind exec to suppress "The input device
is not a TTY" errors. For example: is not a TTY" errors. For example:
`docker-compose exec -T webserver document_exporter ../export` `docker compose exec -T webserver document_exporter ../export`
``` ```
document_exporter target [-c] [-d] [-f] [-na] [-nt] [-p] [-sm] [-z] document_exporter target [-c] [-d] [-f] [-na] [-nt] [-p] [-sm] [-z]

4
docs/advanced_usage.md
View File

@ -236,8 +236,8 @@ webserver:
Troubleshooting: Troubleshooting:
- Monitor the docker-compose log - Monitor the Docker Compose log
`cd ~/paperless-ngx; docker-compose logs -f` `cd ~/paperless-ngx; docker compose logs -f`
- Check your script's permission e.g. in case of permission error - Check your script's permission e.g. in case of permission error
`sudo chmod 755 post-consumption-example.sh` `sudo chmod 755 post-consumption-example.sh`
- Pipe your scripts's output to a log file e.g. - Pipe your scripts's output to a log file e.g.

2
docs/configuration.md
View File

@ -181,7 +181,7 @@ configure their endpoints, and enable the feature.
Defaults to "<http://localhost:3000>". Defaults to "<http://localhost:3000>".
If you run paperless on docker, you can add those services to the If you run paperless on docker, you can add those services to the
docker-compose file (see the provided Docker Compose file (see the provided
[`docker-compose.sqlite-tika.yml`](https://github.com/paperless-ngx/paperless-ngx/blob/main/docker/compose/docker-compose.sqlite-tika.yml) [`docker-compose.sqlite-tika.yml`](https://github.com/paperless-ngx/paperless-ngx/blob/main/docker/compose/docker-compose.sqlite-tika.yml)
file for reference). file for reference).

2
docs/faq.md
View File

@ -83,7 +83,7 @@ has to do much less work to serve the data.
## _How do I install paperless-ngx on Raspberry Pi?_ ## _How do I install paperless-ngx on Raspberry Pi?_
**A:** Docker images are available for arm64 hardware, so just **A:** Docker images are available for arm64 hardware, so just
follow the [docker-compose instructions](https://docs.paperless-ngx.com/setup/#installation). Apart from more required disk follow the [Docker Compose instructions](https://docs.paperless-ngx.com/setup/#installation). Apart from more required disk
space compared to a bare metal installation, docker comes with close to space compared to a bare metal installation, docker comes with close to
zero overhead, even on Raspberry Pi. zero overhead, even on Raspberry Pi.

49
docs/setup.md
View File

@ -25,7 +25,10 @@ necessary configuration files, pull the docker image, start paperless
and create your user account. This script essentially performs all the and create your user account. This script essentially performs all the
steps described in [Docker setup](#docker_hub) automatically. steps described in [Docker setup](#docker_hub) automatically.
1. Make sure that docker and docker-compose are installed. 1. Make sure that Docker and Docker Compose are installed.
!!! tip
See the Docker installation instructions at https://docs.docker.com/engine/install/
2. Download and run the installation script: 2. Download and run the installation script:
@ -62,19 +65,19 @@ steps described in [Docker setup](#docker_hub) automatically.
For new installations, it is recommended to use PostgreSQL as the For new installations, it is recommended to use PostgreSQL as the
database backend. database backend.
3. Install [Docker](https://www.docker.com/) and 3. Install [Docker](https://docs.docker.com/engine/install/) and
[docker-compose](https://docs.docker.com/compose/install/). [Docker Compose](https://docs.docker.com/compose/install/).
!!! warning !!! warning
If you want to use the included `docker-compose.*.yml` file, you If you want to use the included `docker-compose.*.yml` file, you
need to have at least Docker version **17.09.0** and docker-compose need to have at least Docker version **17.09.0** and Docker Compose
version **1.17.0**. To check do: `docker-compose -v` or `docker -v` version **v2**. To check do: `docker compose -v` or `docker -v`
See the [Docker installation guide](https://docs.docker.com/engine/install/) on how to install the current See the [Docker installation guide](https://docs.docker.com/engine/install/) on how to install the current
version of Docker for your operating system or Linux distribution of version of Docker for your operating system or Linux distribution of
choice. To get the latest version of docker-compose, follow the choice. To get the latest version of Docker Compose, follow the
[docker-compose installation guide](https://docs.docker.com/compose/install/linux/) if your package repository [Docker Compose installation guide](https://docs.docker.com/compose/install/linux/) if your package repository
doesn't include it. doesn't include it.
4. Modify `docker-compose.yml` to your preferences. You may want to 4. Modify `docker-compose.yml` to your preferences. You may want to
@ -165,13 +168,13 @@ steps described in [Docker setup](#docker_hub) automatically.
[`PAPERLESS_CONSUMER_POLLING`](configuration.md#PAPERLESS_CONSUMER_POLLING), which will disable inotify. See [`PAPERLESS_CONSUMER_POLLING`](configuration.md#PAPERLESS_CONSUMER_POLLING), which will disable inotify. See
[here](configuration.md#polling). [here](configuration.md#polling).
6. Run `docker-compose pull`. This will pull the image. 6. Run `docker compose pull`. This will pull the image.
7. To be able to login, you will need a super user. To create it, 7. To be able to login, you will need a super user. To create it,
execute the following command: execute the following command:
```shell-session ```shell-session
$ docker-compose run --rm webserver createsuperuser $ docker compose run --rm webserver createsuperuser
``` ```
or using docker exec from within the container: or using docker exec from within the container:
@ -183,7 +186,7 @@ steps described in [Docker setup](#docker_hub) automatically.
This will prompt you to set a username, an optional e-mail address This will prompt you to set a username, an optional e-mail address
and finally a password (at least 8 characters). and finally a password (at least 8 characters).
8. Run `docker-compose up -d`. This will create and start the necessary containers. 8. Run `docker compose up -d`. This will create and start the necessary containers.
9. The default `docker-compose.yml` exports the webserver on your local 9. The default `docker-compose.yml` exports the webserver on your local
port port
@ -209,14 +212,14 @@ steps described in [Docker setup](#docker_hub) automatically.
root as well. root as well.
3. In the `docker-compose.yml` file, find the line that instructs 3. In the `docker-compose.yml` file, find the line that instructs
docker-compose to pull the paperless image from Docker Hub: Docker Compose to pull the paperless image from Docker Hub:
```yaml ```yaml
webserver: webserver:
image: ghcr.io/paperless-ngx/paperless-ngx:latest image: ghcr.io/paperless-ngx/paperless-ngx:latest
``` ```
and replace it with a line that instructs docker-compose to build and replace it with a line that instructs Docker Compose to build
the image from the current working directory instead: the image from the current working directory instead:
```yaml ```yaml
@ -226,10 +229,10 @@ steps described in [Docker setup](#docker_hub) automatically.
``` ```
4. Follow steps 3 to 8 of [Docker Setup](#docker_hub). When asked to run 4. Follow steps 3 to 8 of [Docker Setup](#docker_hub). When asked to run
`docker-compose pull` to pull the image, do `docker compose pull` to pull the image, do
```shell-session ```shell-session
$ docker-compose build $ docker compose build
``` ```
instead to build the image. instead to build the image.
@ -541,7 +544,7 @@ to
image: ghcr.io/paperless-ngx/paperless-ngx:latest image: ghcr.io/paperless-ngx/paperless-ngx:latest
``` ```
and then run `docker-compose up -d` which will pull the new image and then run `docker compose up -d` which will pull the new image
recreate the container. That's it! recreate the container. That's it!
Users who installed with the bare-metal route should also update their Users who installed with the bare-metal route should also update their
@ -570,7 +573,7 @@ installation. The important things to keep in mind are as follows:
- The task scheduler of paperless, which is used to execute periodic - The task scheduler of paperless, which is used to execute periodic
tasks such as email checking and maintenance, requires a tasks such as email checking and maintenance, requires a
[redis](https://redis.io/) message broker instance. The [redis](https://redis.io/) message broker instance. The
docker-compose route takes care of that. Docker Compose route takes care of that.
- The layout of the folder structure for your documents and data - The layout of the folder structure for your documents and data
remains the same, so you can just plug your old docker volumes into remains the same, so you can just plug your old docker volumes into
paperless-ngx and expect it to find everything where it should be. paperless-ngx and expect it to find everything where it should be.
@ -581,7 +584,7 @@ Migration to paperless-ngx is then performed in a few simple steps:
```bash ```bash
$ cd /path/to/current/paperless $ cd /path/to/current/paperless
$ docker-compose down $ docker compose down
``` ```
2. Do a backup for two purposes: If something goes wrong, you still 2. Do a backup for two purposes: If something goes wrong, you still
@ -589,7 +592,7 @@ Migration to paperless-ngx is then performed in a few simple steps:
switch back to paperless. switch back to paperless.
3. Download the latest release of paperless-ngx. You can either go with 3. Download the latest release of paperless-ngx. You can either go with
the docker-compose files from the Docker Compose files from
[here](https://github.com/paperless-ngx/paperless-ngx/tree/main/docker/compose) [here](https://github.com/paperless-ngx/paperless-ngx/tree/main/docker/compose)
or clone the repository to build the image yourself (see or clone the repository to build the image yourself (see
[above](#docker_build)). You can [above](#docker_build)). You can
@ -626,7 +629,7 @@ Migration to paperless-ngx is then performed in a few simple steps:
the search index: the search index:
```shell-session ```shell-session
$ docker-compose run --rm webserver document_index reindex $ docker compose run --rm webserver document_index reindex
``` ```
This will migrate your database and create the search index. After This will migrate your database and create the search index. After
@ -635,7 +638,7 @@ Migration to paperless-ngx is then performed in a few simple steps:
8. Start paperless-ngx. 8. Start paperless-ngx.
```bash ```bash
$ docker-compose up -d $ docker compose up -d
``` ```
This will run paperless in the background and automatically start it This will run paperless in the background and automatically start it
@ -679,7 +682,7 @@ commands as well.
8. Modify the `image:` to point to 8. Modify the `image:` to point to
`ghcr.io/paperless-ngx/paperless-ngx:latest` or a specific version `ghcr.io/paperless-ngx/paperless-ngx:latest` or a specific version
if preferred. if preferred.
9. Start the containers as before, using `docker-compose`. 9. Start the containers as before, using `docker compose`.
## Moving data from SQLite to PostgreSQL or MySQL/MariaDB {#sqlite_to_psql} ## Moving data from SQLite to PostgreSQL or MySQL/MariaDB {#sqlite_to_psql}
@ -737,7 +740,7 @@ below use PostgreSQL, but are applicable to MySQL/MariaDB with the
``` shell-session ``` shell-session
$ cd /path/to/paperless $ cd /path/to/paperless
$ docker-compose run --rm webserver /bin/bash $ docker compose run --rm webserver /bin/bash
``` ```
This will launch the container and initialize the PostgreSQL This will launch the container and initialize the PostgreSQL
@ -790,7 +793,7 @@ Execute this:
```shell-session ```shell-session
$ cd /path/to/paperless $ cd /path/to/paperless
$ docker-compose run --rm webserver migrate documents 0023 $ docker compose run --rm webserver migrate documents 0023
``` ```
Or without docker: Or without docker:

4
docs/troubleshooting.md
View File

@ -6,7 +6,7 @@ Check for the following issues:
- Ensure that the directory you're putting your documents in is the - Ensure that the directory you're putting your documents in is the
folder paperless is watching. With docker, this setting is performed folder paperless is watching. With docker, this setting is performed
in the `docker-compose.yml` file. Without docker, look at the in the `docker-compose.yml` file. Without Docker, look at the
`CONSUMPTION_DIR` setting. Don't adjust this setting if you're `CONSUMPTION_DIR` setting. Don't adjust this setting if you're
using docker. using docker.
@ -120,7 +120,7 @@ Gotenberg raises this error.
You can increase the timeout by configuring a command flag for Gotenberg You can increase the timeout by configuring a command flag for Gotenberg
(see also [here](https://gotenberg.dev/docs/modules/api#properties)). If (see also [here](https://gotenberg.dev/docs/modules/api#properties)). If
using docker-compose, this is achieved by the following configuration using Docker Compose, this is achieved by the following configuration
change in the `docker-compose.yml` file: change in the `docker-compose.yml` file:
```yaml ```yaml

21
install-paperless-ngx.sh
View File

@ -56,14 +56,9 @@ if ! command -v docker &> /dev/null ; then
exit 1 exit 1
fi fi
DOCKER_COMPOSE_CMD="docker-compose" if ! command -v docker compose &> /dev/null ; then
if ! command -v ${DOCKER_COMPOSE_CMD} &> /dev/null ; then echo "docker compose executable not found. Is docker compose installed?"
if docker compose version &> /dev/null ; then exit 1
DOCKER_COMPOSE_CMD="docker compose"
else
echo "docker-compose executable not found. Is docker-compose installed?"
exit 1
fi
fi fi
# Check if user has permissions to run Docker by trying to get the status of Docker (docker status). # Check if user has permissions to run Docker by trying to get the status of Docker (docker status).
@ -382,16 +377,16 @@ if [ "$l1" -eq "$l2" ] ; then
fi fi
${DOCKER_COMPOSE_CMD} pull docker compose pull
if [ "$DATABASE_BACKEND" == "postgres" ] || [ "$DATABASE_BACKEND" == "mariadb" ] ; then if [ "$DATABASE_BACKEND" == "postgres" ] || [ "$DATABASE_BACKEND" == "mariadb" ] ; then
echo "Starting DB first for initilzation" echo "Starting DB first for initilzation"
${DOCKER_COMPOSE_CMD} up --detach db docker compose up --detach db
# hopefully enough time for even the slower systems # hopefully enough time for even the slower systems
sleep 15 sleep 15
${DOCKER_COMPOSE_CMD} stop docker compose stop
fi fi
${DOCKER_COMPOSE_CMD} run --rm -e DJANGO_SUPERUSER_PASSWORD="$PASSWORD" webserver createsuperuser --noinput --username "$USERNAME" --email "$EMAIL" docker compose run --rm -e DJANGO_SUPERUSER_PASSWORD="$PASSWORD" webserver createsuperuser --noinput --username "$USERNAME" --email "$EMAIL"
${DOCKER_COMPOSE_CMD} up --detach docker compose up --detach