{"id":20060660,"url":"https://github.com/mossabtn/spring-dynamic-multi-tenant","last_synced_at":"2026-05-08T06:09:05.123Z","repository":{"id":120134414,"uuid":"289667723","full_name":"MossabTN/spring-dynamic-multi-tenant","owner":"MossabTN","description":null,"archived":false,"fork":false,"pushed_at":"2020-08-23T15:42:47.000Z","size":433,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-01-12T22:14:44.922Z","etag":null,"topics":["angular","keycloak","multitenant","spring"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/MossabTN.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-08-23T10:57:08.000Z","updated_at":"2022-04-07T11:34:08.000Z","dependencies_parsed_at":null,"dependency_job_id":"1b4967d8-7848-4cca-bea5-c9d706860333","html_url":"https://github.com/MossabTN/spring-dynamic-multi-tenant","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MossabTN%2Fspring-dynamic-multi-tenant","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MossabTN%2Fspring-dynamic-multi-tenant/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MossabTN%2Fspring-dynamic-multi-tenant/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MossabTN%2Fspring-dynamic-multi-tenant/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MossabTN","download_url":"https://codeload.github.com/MossabTN/spring-dynamic-multi-tenant/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241488201,"owners_count":19970829,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["angular","keycloak","multitenant","spring"],"created_at":"2024-11-13T13:16:11.956Z","updated_at":"2026-05-08T06:09:00.078Z","avatar_url":"https://github.com/MossabTN.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Spring multi tenant\n\nIn this example, we build a very simple Spring application:\n\n\n## Requirements\n\nTo compile and run this demo you will need:\n- JDK 1.8+\n- NodeJS\n\nMake sure you have this ports available\n- 80\n- 8080\n- 8180\n- 5432\n\n## Setup environment\n* Adding a host name in the /etc/hosts file\n```bash\nsudo gedit /etc/hosts\n\n#paste this hostnames#\n127.0.0.1       tenant1.maxilog.io\n127.0.0.1       tenant2.maxilog.io\n127.0.0.1       tenant3.maxilog.io\n```\n\n* To start a Keycloak Server,Nginx, Postgres  you can use Docker and just run the following command:\n```bash\ndocker-compose -f src/main/docker/docker-compose.yaml up -d\n```\n\nYou should be able to access your Keycloak Server at http://localhost:8180/auth .\n\nLog in as admin to access the Keycloak Administration Console.\nUsername should be `admin` and password `admin`.\n\nFor more details, see the Keycloak documentation about how to https://www.keycloak.org/docs/latest/server_admin/index.html#_create-realm[create a new realm].\n\n\n### Initialized Tenant\n\n###### keycloak realms:\n  - default:\n    - Clients : \n      - front\n      - back | back (backend)\n    - Users : \n      - admin | admin\n      - user | user \n  - tenant1:\n    - Clients : \n      - front\n      - back | back (backend)\n    - Users : \n      - admin | admin\n      - user | user  \n  - tenant2:\n    - Clients : \n      - front\n      - back | back (backend)\n    - Users : \n      - admin | admin\n      - user | user  \n\n###### Databases:\n  - default:\n    - maxilog-default: \n      - maxilog-default-user | maxilog-default-password\n  - tenant1:\n    - maxilog-tenant1: \n      - maxilog-tenant1-user | maxilog-tenant1-password\n  - tenant2:\n    - maxilog-tenant2: \n      - maxilog-tenant2-user | maxilog-tenant2-password\n\n### Get an access token\nChange `REALM`, `USERNAME` and `PASSWORD` by the information of the realm you want to connect :\n```bash\nexport access_token=$(\\\n    curl -X POST http://localhost:8180/auth/realms/REALM/protocol/openid-connect/token \\\n    --header 'Content-Type: application/x-www-form-urlencoded' \\\n    --data-urlencode 'username=USERNAME' \\\n    --data-urlencode 'password=PASSWORD' \\\n    --data-urlencode 'client_id=front' \\\n    --data-urlencode 'grant_type=password' | jq --raw-output '.access_token' \\\n )\n````\n\nExample :\n\n```bash\nexport access_token=$( \\\n    curl -X POST http://localhost:8180/auth/realms/tenant1/protocol/openid-connect/token \\\n    --header 'Content-Type: application/x-www-form-urlencoded' \\\n    --data-urlencode 'username=admin' \\\n    --data-urlencode 'password=admin' \\\n    --data-urlencode 'client_id=front' \\\n    --data-urlencode 'grant_type=password' | jq --raw-output '.access_token' \\\n )\n```\n\n### Get your task list\nIf you get the token from `tenant1` realm :\n\n```bash\ncurl -X GET -v http://localhost:8080/api/tasks/me \\\n--header  \"x-tenant: tenant1\" \\\n--header  \"Authorization: Bearer $access_token\"\n```\n\n### Create new Tenant\nTo create new tenant you have to use `default` tenant.\n\nLet's create tenant named `tenant3`\n```bash\nexport access_token=$(\\\n    curl -X POST http://localhost:8180/auth/realms/default/protocol/openid-connect/token \\\n    --header 'Content-Type: application/x-www-form-urlencoded' \\\n    --data-urlencode 'username=admin' \\\n    --data-urlencode 'password=admin' \\\n    --data-urlencode 'client_id=front' \\\n    --data-urlencode 'grant_type=password' | jq --raw-output '.access_token' \\\n )\n \ncurl -X POST -v http://localhost:8080/api/tenants/tenant3 \\\n--header  \"x-tenant: default\" \\\n--header  \"Authorization: Bearer $access_token\"\n```\n\nThis command will create realm `tenant3` and database `maxilog-tenant3`.\n\nPS: In this case, you have to add hostname to `/etc/hosts` :\n\n`127.0.0.1       tenant3.maxilog.io`\n\n\n#### Backend(spring)\n\u003e ./mvnw spring-boot:run\n\nThis command will leave Spring running in the foreground listening on port 8080.\n\n#### Frontend(angular)\n```bash\ncd src/main/webapp/\nnpm install\nnpm start\n```\nYou should be able to access your angular app at `http://tenant1.maxilog.io` or `http://tenant2.maxilog.io`.\n\n![test](tenant1-ss.gif)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmossabtn%2Fspring-dynamic-multi-tenant","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmossabtn%2Fspring-dynamic-multi-tenant","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmossabtn%2Fspring-dynamic-multi-tenant/lists"}