You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Go to file
Ludwig Behm 146e8e0dff Merge branch 'develop' of into develop 1 year ago
.github/workflows Generate i18n files on ci/cd 1 year ago
.husky Adding Prettier in messages 1 year ago
back Merge branch 'develop' of into develop 1 year ago
benchmark Bump path-parse from 1.0.6 to 1.0.7 in /benchmark 2 years ago
contrib Merge branch 'develop' of into develop 1 year ago
docs Adding missing reference to Camera doc 1 year ago
front Merge branch 'develop' of into develop 1 year ago
maps Merge branch 'develop' of into move-to-improvements 1 year ago
messages Bump shelljs from 0.8.4 to 0.8.5 in /messages 1 year ago
pusher Merge branch 'develop' of into develop 1 year ago
tests Bump follow-redirects from 1.14.7 to 1.14.8 in /tests 1 year ago
uploader Bump path-parse from 1.0.6 to 1.0.7 in /uploader 2 years ago
.dockerignore *: Dockerfiles cleanup, 2 years ago
.env.template Fix feedback @moufmouf 2 years ago
.gitignore added husky to gitignore 2 years ago Add multi co website to the changelog 2 years ago Move translate documentation 1 year ago
README-LOGO.svg Updated README (logo, map, wording) (#1485) 2 years ago
README-MAP.png Updated README (logo, map, wording) (#1485) 2 years ago Adding a reference to awesome-workadventure in README 1 year ago Create 2 years ago
Vagrantfile.template Update vagrant template 2 years ago
deeployer.libsonnet Fixing server name in K8S deployment 1 year ago
docker-compose.single-domain.yaml Merge branch 'master' of into develop 2 years ago
docker-compose.testcafe.yml Fixing admin token for requests 1 year ago
docker-compose.yaml Fix pusher and back locked 1 year ago
package-lock.json Merge remote-tracking branch 'remotes/upstream/develop' into trigger-message-refv3 2 years ago
package.json Revert "Improving log messages" 2 years ago
yarn.lock yarn.lock update 1 year ago


WorkAdventure logo WorkAdventure office image

Live demo here.


WorkAdventure is a web-based collaborative workspace presented in the form of a 16-bit video game.

In WorkAdventure you can move around your office and talk to your colleagues (using a video-chat system, triggered when you approach someone).

See more features for your virtual office:

Community resources

Check out resources developed by the WorkAdventure community at awesome-workadventure

Setting up a development environment

Install Docker.


cp .env.template .env
docker-compose up -d

The environment will start.

You should now be able to browse to http://play.workadventure.localhost/ and see the application. You can view the dashboard at http://workadventure.localhost:8080/

Note: on some OSes, you will need to add this line to your /etc/hosts file:

/etc/hosts workadventure.localhost

Note: If on the first run you get a page with "network error". Try to docker-compose stop , then docker-compose start. Note 2: If you are still getting "network error". Make sure you are authorizing the self-signed certificate by entering https://pusher.workadventure.localhost and accepting them.

MacOS developers, your environment with Vagrant

If you are using MacOS, you can increase Docker performance using Vagrant. If you want more explanations, you can read this medium article.


First steps

Create a config file Vagrantfile from Vagrantfile.template

cp Vagrantfile.template Vagrantfile

In Vagrantfile, update VM_HOST_PATH with the local project path of your machine.

#VM_HOST_PATH# => your local machine path to the project

(run pwd and copy the path in this variable)

To start your VM Vagrant, run:

Vagrant up

To connect to your VM, run:

Vagrant ssh

To start project environment, run

docker-compose up

You environment runs in you VM Vagrant. When you want stop your VM, you can run:

Vagrant halt

If you want to destroy, you can run

Vagrant destroy

Available commands

  • Vagrant up: start your VM Vagrant.
  • Vagrant reload: reload your VM Vagrant when you change Vagrantfile.
  • Vagrant ssh: connect on your VM Vagrant.
  • Vagrant halt: stop your VM Vagrant.
  • Vagrant destroy: delete your VM Vagrant.

Setting up a production environment

The way you set up your production environment will highly depend on your servers. We provide a production ready docker-compose file that you can use as a good starting point in the contrib/docker directory.