GV

GeezerVison

The World Wide Web, restored to 800 pixels of glory.

Home|About|Gaming cabinet|Archives|How it works|Starter sites

On this site

  • Sign in
  • ActionsCI/CD and automation
  • CodespacesCloud development environments
  • All Features
  • Documentation
  • Training
  • Certifications
  • Build with Copilot
  • Customize Copilot
  • Integrations
  • Trending repos
  • GitHub Sponsors
  • Developer articles
  • Enterprises

This view

  • Original page
  • New address

GeezerVison is showing github.com — node-solid-server/docker-image at main · nodeSolidServer/node-solid-server

Expand file tree

/

docker-image

/
Copy path

Directory actions

More options

More options

Directory actions

More options

More options

Latest commit

 

History

History
History
/

docker-image

/
Copy path

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
examples
examples
 
 
src
src
 
 
test
test
 
 
.dockerignore
.dockerignore
 
 
.gitignore
.gitignore
 
 
CONTRIBUTING.md
CONTRIBUTING.md
 
 
Makefile
Makefile
 
 
README.md
README.md
 
 

README.md

Outline

NSS Docker image

Containerized version of node-solid-server

How to use

For quickly trying out this image or solid-server in general you can run:

docker run -p 8443:8443 nodesolidserver/node-solid-server

You will be able to access the server via https://localhost:8443 then. It will use auto-generated self-signed certificates and is not suited for production use. For a production server you will have to create some real certificates and configure environment variables, like SOLID_SERVER_URI, SOLID_SSL_KEY and SOLID_SSL_CERT. Take a look at the examples folder at GitHub for details.

Environment variables

All solid configuration flags can be set by an equivalent environment variable. The official solid-server documentation explains them in detail.

Docker compose

For a productive setup you may want to use docker-compose. Example setups can be found in the examples folder. Here is an overview of what is in there:

Simple setup without proxy

./examples/docker-compose.simple.yml

Run solid-server directly on HTTPS port 443 without a proxy in between. You will need to have your certificates ready and mount them into the container.

Running solid behind nginx proxy

./examples/docker-compose.nginx.yml

Run solid-server on port 8443 behind a nginx proxy on 443. You will need to setup an nginx container with letsencrypt companion as described here.

When using nginx to proxy HTTPS connections to Solid you will need to specify HTTPS in the local service URI:

proxy_pass https://127.0.0.1:8443;

This approach is useful if you do not wish to grant Solid access to your HTTPS certificates, as nginx does not validate the self-signed certificates that Solid generates for its proxy_pass connection.

All-in one nginx proxy + letsencrypt + solid server

./examples/docker-compose.all-in-one.yml

Run solid-server on port 8443 behind a nginx proxy on 443, including certificate generation via letsencrypt companion.

Other setups

The setup you need is not presented here? Feel free to ask, or provide a Pull Request with your solution.

Feedback & Discussion

There is a topic in the Solid Forum, you are welcome to join in.

Contributing

If you would like to contribute to the development of this image, see CONTRIBUTING.md

You are visitor 01402503 — GeezerVison does not store the pages you look up.
Best viewed with Netscape Navigator 4.7 or Internet Explorer 6 at 800×600. No cookies required.