workadventure /workadventure
A collaborative web application (virtual office) presented as a 16-bit RPG video game
★ 5,934⑂ 1,015👁 47⑃ 4,992● 1,980▤ 291
+2
Daily
5,934
stars
1,015
forks
47
watchers
4,992
prs
1,980
issues
291
releases
README
! !Awesome
!WorkAdventure office image
WorkAdventure
WorkAdventure is a platform that allows you to design fully customizable collaborative virtual worlds (metaverse).
With your own avatar, you can interact spontaneously with your colleagues, clients, partners (using a video-chat system, triggered when you approach someone).
Imagine all types of immersive experiences (recruitments, onboarding, trainings, digital workplace, internal/external events) on desktop, mobile or tablet.
_The little plus? The platform is GDPR and open source!_
See more features for your virtual office!
Pricing for our SaaS version!
Support our team!
!Stats repo
Contributors
Thanks to everyone who contributes to WorkAdventure!
Community resources
1. Want to build your own map, check out our map building documentation
2. Check out resources developed by the WorkAdventure community at awesome-workadventure
Setting up a production environment
We support 2 ways to set up a production environment:
- using Docker Compose
- or using a Helm chart for Kubernetes
Please check the Setting up a production environment guide for more information.
[!NOTE]
WorkAdventure also provides a hosted version of the application. Using the hosted version is
the easiest way to get started and helps us to keep the project alive.
Setting up a development environment
[!NOTE]
These installation instructions are for local development only. They will not work on
remote servers as local environments do not have HTTPS certificates.
Install Docker and clone this repository.
[!WARNING]
If you are using Windows, make sure the End-Of-Line character is not modified by the cloning process by setting
the core.autocrlf setting to false: git config --global core.autocrlf false
Run:
cp .env.template .env
docker-compose up
The environment will start with the OIDC mock server enabled by default.
You should now be able to browse to http://play.workadventure.localhost/ and see the application.
You can view the Traefik dashboard at http://traefik.workadventure.localhost
(Test user is "User1" and password is "pwd")
If you want to disable the OIDC mock server (for anonymous access), you can run:
console
$ docker-compose -f docker-compose.yaml -f docker-compose-no-oidc.yaml up
Note: on some OSes, you will need to add this line to your /etc/hosts file:
/etc/hosts
127.0.0.1 oidc.workadventure.localhost redis.workadventure.localhost play.workadventure.localhost traefik.workadventure.localhost matrix.workadventure.localhost extra.workadventure.localhost icon.workadventure.localhost map-storage.workadventure.localhost maps.workadventure.localhost api.workadventure.localhost front.workadventure.localhost
Troubleshooting
See our troubleshooting guide.Top issues
#5825WebSocket disconnects after login with Microsoft Entra ID on self-hosted Docker Compose deployment89 comments · 2026-03-08#932NETWORK ERROR when docker-compose up20 comments · 2021-04-23#1632Bubble doesn't work since last friday19 comments · 2021-12-07#6197Gravatar18 comments · 2026-06-08#5579Waiting for OIDC mock server to be up indefenitly17 comments · 2026-01-15#3334Jitsi problem after upgrading to 1.15.1214 comments · 2023-06-23#3034Where and how is "Scripting API Extra" initialized?13 comments · 2023-02-09#1304Feature Request: Being able to 'pin' a proximity chat so users can move their avatars as they talk13 comments · 2021-07-22
Discussions
#6262[HIRING] Lead Sales Consultant — Remote (Mountain Daylight Time) 0 comments · 2026-06-22#5971Is it possible to use teams integration and self hosting? Paying for a sub/service is fine, just wondering if it's possible0 comments · 2026-04-13#5676Getting Started0 comments · 2026-02-08#5297Background noise reduction in proximity chat?0 comments · 2025-10-30#5171docker self-hosted + Google OpenID: has someone succeeded to configure it?0 comments · 2025-09-24#5048Deploy problem with chat0 comments · 2025-08-25#5008deployment issue0 comments · 2025-08-05#4352[Workadventure] Jitsi | Call will disconnect after 5 minutes0 comments · 2024-10-25
Latest release
v1.34.5 v1.34.5 2026-10-27Bug fix fix(chat): let text messages through past the file transfer user limit by @moufmouf in https://github.com/workadventure/workadventure/pull/6857 Full Changelog: https://github.com/workadventure/workadventure/compare/v1.34.4...v1.34.5