From 060a0863c085dd54030aeae29499134119791f74 Mon Sep 17 00:00:00 2001 From: Auke van Slooten Date: Fri, 19 Jun 2026 14:15:12 +0200 Subject: [PATCH 1/2] added simpler docker commands, added init-devusers.php info --- README.md | 21 ++++++++++++++------- 1 file changed, 14 insertions(+), 7 deletions(-) diff --git a/README.md b/README.md index ee8a607..33826af 100644 --- a/README.md +++ b/README.md @@ -10,19 +10,26 @@ For the user management, no framework is used to keep the codebase lean. Start the docker containers: ```sh -docker-compose up +docker compose up ``` This will start up three containers: the solid server, pubsub server and a mailpit server. If you have an actual SMTP server running, feel free to remove the mailpit container. The persisted data will be stored in the data/ directory. This contains the keys, pods, db and mailpit data. -Run the following commands to set up the container (replace 'solid' below with the name of your container): -Note: Update the values in the config.php file where needed befure running the init script. +Run the following commands to set up the container: +Note: Update the values in the config.php file where needed before running the init script. ```sh -docker exec -w /opt/solid/ solid cp config.php.example config.php -docker exec -u www-data -i -w /opt/solid/ solid php init.php -docker exec -w /opt/solid/ solid chown -R www-data:www-data keys pods profiles db +docker compose exec -w /opt/solid/ solid cp config.php.example config.php +docker compose exec -w /opt/solid/ solid chown -R www-data:www-data keys pods profiles db +docker compose exec -u www-data -i -w /opt/solid/ solid php init.php +``` + +If you need dev user accounts bob and alice, also run this: + +```sh +docker compose exec -u www-data -i -w /opt/solid/ solid php init-devusers.php +docker compose exec -w /opt/solid/ solid chown -R www-data:www-data keys pods profiles db # again ``` Now add the following host to your `/etc/hosts` file: @@ -30,7 +37,7 @@ Now add the following host to your `/etc/hosts` file: 127.0.0.1 solid.local ``` -And browser to `https://solid.local/`. After you register a new account, you'll get an identity and storage hostname, add these to `/etc/hosts` as well, e.g: +And browse to `https://solid.local/`. After you register a new account, you'll get an identity and storage hostname, add these to `/etc/hosts` as well, e.g: ``` 127.0.0.1 id-d1f0e8c54e755cb45b61ee8e9dad00fe.solid.local storage-d1f0e8c54e755cb45b61ee8e9dad00fe.solid.local ``` From 51755434f2df01ed6d5ebed1c06cbd294f8f5e78 Mon Sep 17 00:00:00 2001 From: Yvo Brevoort Date: Tue, 7 Jul 2026 13:20:32 +0200 Subject: [PATCH 2/2] use the existing init script --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 33826af..be089b2 100644 --- a/README.md +++ b/README.md @@ -28,7 +28,7 @@ docker compose exec -u www-data -i -w /opt/solid/ solid php init.php If you need dev user accounts bob and alice, also run this: ```sh -docker compose exec -u www-data -i -w /opt/solid/ solid php init-devusers.php +docker compose exec -u www-data -i -w /opt/solid/ solid php tests/testsuite/init-testsuite.php docker compose exec -w /opt/solid/ solid chown -R www-data:www-data keys pods profiles db # again ```