Skip to content

Instantly share code, notes, and snippets.

What would you like to do?
Run a Solid server locally, with all the quirks and features

Solid server locally

This readme applies to v5.0.0-beta.5. Version 4.4.0 (stable at the time of release) is broken.

Generate self-signed certificate

Create a secrets file:

touch ~/.secret

Make sure it looks like this:


Then source it:

. ~/.secret

And generate the necessary files:

openssl genrsa -des3 -passout pass:$PASSPHRASE -out server.pass.key 2048;
openssl rsa -passin pass:$PASSPHRASE -in server.pass.key -out server.key;
openssl req -new -key server.key -out server.csr;
openssl x509 -req -sha256 -days 365 -in server.csr -signkey server.key -out server.crt;

Clone and run the solid server

git clone;
cd node-solid-server;
git checkout v5.0.0-beta.5; #IMPORTANT
npm install;
npm run solid init;

Make sure to disable multiuser!

Fill in the info, after that a ./config.json file will be made, this is what mine looks like:

  "root": "/Users/kevin/git/node-solid-server/data",
  "port": "8443",
  "serverUri": "https://localhost:8443",
  "webid": true,
  "mount": "/",
  "configPath": "./config",
  "configFile": "./config.json",
  "dbPath": "./.db",
  "sslKey": "/Users/kevin/server.key",
  "sslCert": "/Users/kevin/server.crt",
  "multiuser": false,
  "server": {
    "name": "localhost",
    "description": "",
    "logo": ""

Then start the server with some magic to allow for self signed certificates:

export NODE_TLS_REJECT_UNAUTHORIZED=0 && npm run solid start -- --no-reject-unauthorized

Hosts file entry

Before anything else, edit your hosts file:

sudo nano /etc/hosts

And add *.localhost to it.


You should now see your frontend on https://localhost:8443/, you'll need to click through the warning messages of the self signed certificate of course.

Sometimes the register or login buttons will not be visible, so you may have to go to https://localhost:8443/register directly to create a new account.

Get through the even more quirky stuff

Applicable to v5.0.0-beta.5

In my example I registered the account kevin, so then go to https://kevin.localhost:8443 and click login. For some reason if you want to auth using kevin.localhost:8443, you'll get an Unatuhorized message.

Instead, click on another domain, I tried "Solid Test Space". Then go back and authorization using kevin.localhost:8443 should work.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
You can’t perform that action at this time.