Deploy with an agent
Copy agent prompt
Before you start
Connect your AWS account using the Spring Winter quickstart. You need postgreSQL, a compatible Redis broker and durable document and data files. Check the upstream deployment instructions and pin a release before you deploy. Source repository.Create and connect the database
- Create a private SQL database with PostgreSQL for this deployment. If you already have a database for this deployment, verify that the engine and version match the pinned app release. Wait for the database to be ready.
- Open Connect on the database. Use the writer endpoint, port, database name and application credentials. Create the application database and role if needed. Confirm that the application and migration process can reach the private writer.
- Set
PAPERLESS_DBENGINE=postgresqland the release’sPAPERLESS_DB*settings. Make the Redis-compatible broker reachable and configurePAPERLESS_REDIS. Attach durable media and data storage before startup. Put secret values in runtime configuration or the migration process’s secret store. - Start Paperless-ngx and wait for migrations before uploading documents.
Configure the deployment
- Select a Spring Winter project in the AWS Region you want to use. Confirm where persistent or non-HTTP components will run before creating resources.
- Use the official Paperless-ngx image on port 8000.
- Set PAPERLESS_URL, PAPERLESS_SECRET_KEY, PAPERLESS_REDIS and the selected release’s PAPERLESS_DB* settings.
- Keep document media and data on durable storage.
- Account for the consume and export directories if you use file ingestion or exports.
- Use a persistent host for the standard mount-based layout.