Improve README with the default host port

This commit is contained in:
Pierre Ozoux 2017-06-10 11:25:44 +01:00 committed by GitHub
parent d022c79bea
commit d8d130a258

View File

@ -18,10 +18,10 @@ The second option is a `fpm` container. It is based on the [php-fpm](https://hub
The apache image contains a webserver and exposes port 80. To start the container type: The apache image contains a webserver and exposes port 80. To start the container type:
```console ```console
$ docker run -d nextcloud $ docker run -d -p 8080:80 nextcloud
``` ```
Now you can access Nextcloud at http://localhost/ from your host system. Now you can access Nextcloud at http://localhost:8080/ from your host system.
## Using the fpm image ## Using the fpm image
@ -111,6 +111,8 @@ services:
app: app:
image: nextcloud image: nextcloud
ports:
- 8080:80
links: links:
- db - db
volumes: volumes:
@ -119,6 +121,8 @@ services:
``` ```
Then run `docker-compose up -d`, now you can access Nextcloud at http://localhost:8080/ from your host system.
## Base version - FPM ## Base version - FPM
When using the FPM image you need another container that acts as web server on port 80 and proxies the requests to the Nextcloud container. In this example a simple nginx container is combindes with the Nextcloud-fpm image and a MariaDB database container. The data is stored in docker volumes. The nginx container also need access to static files from your Nextcloud installation. It gets access to all the volumes mounted to Nextcloud via the `volumes_from` option.The configuration for nginx is stored in the configuration file `nginx.conf`, that is mounted into the container. An example can be found in the examples section [here](https://github.com/nextcloud/docker/tree/master/.examples). When using the FPM image you need another container that acts as web server on port 80 and proxies the requests to the Nextcloud container. In this example a simple nginx container is combindes with the Nextcloud-fpm image and a MariaDB database container. The data is stored in docker volumes. The nginx container also need access to static files from your Nextcloud installation. It gets access to all the volumes mounted to Nextcloud via the `volumes_from` option.The configuration for nginx is stored in the configuration file `nginx.conf`, that is mounted into the container. An example can be found in the examples section [here](https://github.com/nextcloud/docker/tree/master/.examples).
@ -155,6 +159,8 @@ services:
web: web:
image: nginx image: nginx
ports:
- 8080:80
links: links:
- app - app
volumes: volumes:
@ -163,6 +169,9 @@ services:
- app - app
restart: always restart: always
``` ```
Then run `docker-compose up -d`, now you can access Nextcloud at http://localhost:8080/ from your host system.
# Make your Nextcloud available from the internet # Make your Nextcloud available from the internet
Until here your Nextcloud is just available from you docker host. If you want you Nextcloud available from the internet adding SSL encryption is mandatory. Until here your Nextcloud is just available from you docker host. If you want you Nextcloud available from the internet adding SSL encryption is mandatory.
@ -173,32 +182,6 @@ We recommend using a reverse proxy in front of our Nextcloud installation. Your
In our [examples](https://github.com/nextcloud/docker/tree/master/.examples) section we have an example for a fully automated setup using a reverse proxy, a container for [Let's Encrypt](https://letsencrypt.org/) certificate handling, database and Nextcloud. It uses the popular [nginx-proxy](https://github.com/jwilder/nginx-proxy) and [docker-letsencrypt-nginx-proxy-companion](https://github.com/JrCs/docker-letsencrypt-nginx-proxy-companion) containers. Please check the according documentations before using this setup. In our [examples](https://github.com/nextcloud/docker/tree/master/.examples) section we have an example for a fully automated setup using a reverse proxy, a container for [Let's Encrypt](https://letsencrypt.org/) certificate handling, database and Nextcloud. It uses the popular [nginx-proxy](https://github.com/jwilder/nginx-proxy) and [docker-letsencrypt-nginx-proxy-companion](https://github.com/JrCs/docker-letsencrypt-nginx-proxy-companion) containers. Please check the according documentations before using this setup.
## HTTP - insecure, just for development / debugging / testing
When you're testing you can use this image without the ssl encryption. **Never use this method on a Nextcloud install where actual user data is stored!**
You just have to map the webserver port to your host. For the apache image add `-p 80:80` to your docker run command or add to your compose file:
```diff
...
app:
image: nextcloud
+ ports:
+ - 80:80
...
```
For the fpm image you need a webserver in front. If you're following the docker-compose example above, add:
```diff
...
web:
image: nginx
+ ports:
+ - 80:80
...
```
# First use # First use
When you first access your Nextcloud, the setup wizard will appear and ask you to choose an administrator account, password and the database connection. For the database use `db` as host and `nextcloud` as table and user name. Also enter the password you chose in your `docker-compose.yml` file. When you first access your Nextcloud, the setup wizard will appear and ask you to choose an administrator account, password and the database connection. For the database use `db` as host and `nextcloud` as table and user name. Also enter the password you chose in your `docker-compose.yml` file.