https://github.com/angelo-v/docker-solid-server

Containerized version of node-solid-server
https://github.com/angelo-v/docker-solid-server

docker linked-data solid solid-server

Last synced: 25 days ago
JSON representation

Containerized version of node-solid-server

• Host: GitHub
• URL: https://github.com/angelo-v/docker-solid-server
• Owner: angelo-v
• License: mit
• Created: 2018-12-01T19:34:08.000Z (almost 6 years ago)
• Default Branch: main
• Last Pushed: 2022-04-08T09:43:38.000Z (over 2 years ago)
• Last Synced: 2024-08-02T12:46:38.529Z (3 months ago)
• Topics: docker, linked-data, solid, solid-server
• Language: Python
• Size: 40 KB
• Stars: 22
• Watchers: 8
• Forks: 8
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-starred - angelo-v/docker-solid-server - Containerized version of node-solid-server (docker)

README

        
# docker-solid-server

Containerized version of node-solid-server

## How to use

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

```bash

docker run -p 8443:8443 aveltens/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](https://github.com/angelo-v/docker-solid-server/tree/master/examples) 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](https://github.com/solid/node-solid-server#extra-flags-expert).

### Docker compose

For a productive setup you may want to use docker-compose. Example setups can be found

in the [examples folder](https://github.com/angelo-v/docker-solid-server/tree/master/examples). 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](https://github.com/JrCs/docker-letsencrypt-nginx-proxy-companion).

#### 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](https://hub.docker.com/r/jwilder/nginx-proxy/) on 443, including

certificate generation via [letsencrypt companion](https://github.com/JrCs/docker-letsencrypt-nginx-proxy-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](https://forum.solidproject.org/t/official-solid-docker-image/748/5),

you are welcome to join in.

## Contributing

If you would like to contribute to the development of this image,

see [CONTRIBUTING.md](./CONTRIBUTING.md)