Updated docs, new docker tags
This commit is contained in:
57
doc/IMPORTING.md
Normal file
57
doc/IMPORTING.md
Normal file
@ -0,0 +1,57 @@
|
||||
## Importing from Version 1
|
||||
|
||||
Thanks for using Nginx Proxy Manager version 1. It sucked.
|
||||
|
||||
But it worked.
|
||||
|
||||
This guide will let your import your configuration from version 1 to version 2.
|
||||
|
||||
**IMPORTANT: This will make changes to your `letsencrypt` folder and certificate files!** Make sure you back them up first.
|
||||
|
||||
|
||||
### Link your previous folders in your new docker stack
|
||||
|
||||
In version 1, the docker configuration asked for a `config` folder to be linked and a `letsencrypt` folder. However in version 2, the
|
||||
configuration exists in the database, so the `config` folder is no longer required. However if you have this folder linked in a
|
||||
version 2 stack, the application will automatically import that configuration the first time it finds it.
|
||||
|
||||
Following the [example configuration](../example):
|
||||
|
||||
```yaml
|
||||
version: "3"
|
||||
services:
|
||||
app:
|
||||
image: jc21/nginx-proxy-manager:2
|
||||
restart: always
|
||||
ports:
|
||||
- 80:80
|
||||
- 81:81
|
||||
- 443:443
|
||||
volumes:
|
||||
- ./config.json:/app/config/production.json
|
||||
- ./data:/data
|
||||
- ./letsencrypt:/etc/letsencrypt # this is your previous letsencrypt folder
|
||||
- ./config:/config # this is your previous config folder
|
||||
depends_on:
|
||||
- db
|
||||
db:
|
||||
image: mariadb
|
||||
restart: always
|
||||
environment:
|
||||
MYSQL_ROOT_PASSWORD: "password123"
|
||||
MYSQL_DATABASE: "nginxproxymanager"
|
||||
MYSQL_USER: "nginxproxymanager"
|
||||
MYSQL_PASSWORD: "password123"
|
||||
volumes:
|
||||
- ./data/mysql:/var/lib/mysql
|
||||
```
|
||||
|
||||
After you start the stack, the import will begin just after database initialize.
|
||||
|
||||
Some notes:
|
||||
- After importing, a file is created in the `config` folder to signify that it has been imported and should not be imported again.
|
||||
- Because no users previously existed in the version 1 config, the `admin@example.com` user will own all of the imported data.
|
||||
- If you were crazy like me and used Nginx Proxy Manager version 1 to proxy the Admin interface behind a Access List, you should
|
||||
really disable the access list for that proxy host in version 1 before importing in to version 2. The app doesn't like being behind basic
|
||||
authentication and it's own internal authentication. If you forgot to do this before importing, just hit the admin interface directly
|
||||
on port 81 to get around your basic authentication access list.
|
@ -3,7 +3,7 @@
|
||||
There's a few ways to configure this app depending on:
|
||||
|
||||
- Whether you use `docker-compose` or vanilla docker
|
||||
- Which architecture you're running it on (raspberry pi also supported)
|
||||
- Which architecture you're running it on (raspberry pi also supported - Testers wanted!)
|
||||
|
||||
### Configuration File
|
||||
|
||||
@ -36,7 +36,7 @@ affect the login and session management of the application. If these keys change
|
||||
|
||||
### Database
|
||||
|
||||
This app doesn't come with a database, you have to provide one yourself. Currently `mysql` and `postgres` databases are supported.
|
||||
This app doesn't come with a database, you have to provide one yourself. Currently only `mysql/mariadb` is supported.
|
||||
|
||||
It's easy to use another docker container for your database also and link it as part of the docker stack. Here's an example:
|
||||
|
||||
@ -46,7 +46,10 @@ services:
|
||||
app:
|
||||
image: jc21/nginx-proxy-manager:2
|
||||
restart: always
|
||||
network_mode: host
|
||||
ports:
|
||||
- 80:80
|
||||
- 81:81
|
||||
- 443:443
|
||||
volumes:
|
||||
- ./config.json:/app/config/production.json
|
||||
- ./data:/data
|
||||
@ -76,7 +79,10 @@ services:
|
||||
app:
|
||||
image: jc21/nginx-proxy-manager:2
|
||||
restart: always
|
||||
network_mode: host
|
||||
ports:
|
||||
- 80:80
|
||||
- 81:81
|
||||
- 443:443
|
||||
volumes:
|
||||
- ./config.json:/app/config/production.json
|
||||
- ./data:/data
|
||||
@ -88,7 +94,9 @@ Vanilla Docker:
|
||||
```bash
|
||||
docker run -d \
|
||||
--name nginx-proxy-manager \
|
||||
--network host \
|
||||
-p 80:80 \
|
||||
-p 81:81 \
|
||||
-p 443:443 \
|
||||
-v /path/to/config.json:/app/config/production.json \
|
||||
-v /path/to/data:/data \
|
||||
-v /path/to/letsencrypt:/etc/letsencrypt \
|
||||
@ -102,20 +110,11 @@ I have created a `armhf` docker container just for you. There may be issues with
|
||||
if you have issues please report them here.
|
||||
|
||||
```bash
|
||||
# Postgres:
|
||||
docker run -d \
|
||||
--name nginx-proxy-manager-db \
|
||||
--network host \
|
||||
-e POSTGRES_DB=nginxproxymanager \
|
||||
-e POSTGRES_USER=nginxproxymanager \
|
||||
-e POSTGRES_PASSWORD=password123 \
|
||||
-v /path/to/postgresql:/var/lib/postgresql/data \
|
||||
zsoltm/postgresql-armhf
|
||||
|
||||
# NPM:
|
||||
docker run -d \
|
||||
--name nginx-proxy-manager-app \
|
||||
--network host \
|
||||
-p 80:80 \
|
||||
-p 81:81 \
|
||||
-p 443:443 \
|
||||
-v /path/to/config.json:/app/config/production.json \
|
||||
-v /path/to/data:/data \
|
||||
-v /path/to/letsencrypt:/etc/letsencrypt \
|
||||
|
@ -1,3 +0,0 @@
|
||||
## Migrating from Version 1
|
||||
|
||||
TODO
|
@ -3,12 +3,19 @@ services:
|
||||
app:
|
||||
image: jc21/nginx-proxy-manager:2
|
||||
restart: always
|
||||
ports:
|
||||
- 80:80
|
||||
- 81:81
|
||||
- 443:443
|
||||
volumes:
|
||||
- ./config.json:/app/config/production.json
|
||||
- ./data:/data
|
||||
- ./letsencrypt:/etc/letsencrypt
|
||||
depends_on:
|
||||
- db
|
||||
environment:
|
||||
# if you want pretty colors in your docker logs:
|
||||
- FORCE_COLOR=1
|
||||
db:
|
||||
image: mariadb
|
||||
restart: always
|
||||
|
Reference in New Issue
Block a user