immers

ActivityPub server for immers.space - a decentralized virtual reality metaverse platform powered by Mozilla Hubs and activitypub-express.

Installation

We provide a Docker Hub image for immers, and the immers-app repo contains docker-compose configuration, configuration script, and deploy instructions. If you prefer to run immers without docker, it can be deployed just like any other NodeJS & MongoDB app.

Configuration

Immers looks for the following configuration values as environment variables or in a .env file in the project root.

Required configuration

Variable | Value | Example --- | --- | --- name | Name of your immer | Immers Space domain | Domain name for your immers server | immers.space hub | Domain name for your Mozilla Hubs Cloud or other connected immersive experience | hub.immers.space smtpHost | Mail service domain (for password resets) | smtp.sendgrid.net smtpPort | Mail service port | 587 smtpUser | Mail service username | apikey smtpPassword | Mail service password | sessionSecret | Secret key for session cookie encryption | Automatically generated when using setup script easySecret | Secret key for email token encryption | Automatically generated when using setup script

Optional configuration

Variable | Value | Default --- | --- | --- homepage | Redirect root html requests to this url | Use hub url googleFont | Font family name from to fetch from Google Fonts for immer name header | Monoton backgroundColor | CSS color | #a6549d backgroundImage | Image file | vapor.png icon | Image file | vaporwave-icon.png imageAttributionText | Attribution for backgroundImage, if needed | Vectors by Vecteezy imageAttributionUrl | Attribution for backgroundImage, if needed | https://www.vecteezy.com/free-vector/vector monetizationPointer | Payment pointer for Web Monetization on login & profile pages | Immers Space organization wallet dbName | Database name to use with MongoDb | mongodb port | Port number for immers sever | 8081 smtpFrom | From address for emails | noreplay@mail.domain emailOptInURL | Link to an opt-in form for email updates to show on registration page | None emailOptInParam | Query parameter for emailOptInURL for the e-mail address | Use opt-in url without inserting e-mail emailOptInNameParam | Query parameter for emailOptInURL for the name | Use opt-in url without inserting name systemUserName | Username for a "Service" type actor representing the Immer, enables welcome messages and Mastodon secure mode compatibility | none (does not create service actor) systemDisplayName | Sets the display name for the service actor | none welcome | HTML file for a message that will be delivered from the system user to new user's inboxes (requires systemUserName) | none (does not send message) keyPath, certPath, caPath | Local development only. Relative paths to certificate files | None

Local dev

immers

• Clone and install immers

git clone https://github.com/immers-space/immers.git
cd immers
npm ci

• Install a self-signed certificate

mkdir certs
sudo openssl req -x509 -nodes -days 365 -newkey rsa:2048 -keyout certs/server.key -out certs/server.cert

• Install mongodb
• Run immer with npm run dev

hubs

• Clone and install our fork

git clone https://github.com/immers-space/hubs.git
cd hubs
git checkout immers-integration
npm ci
npm run build:client

• Run hub with either npm run dev (use Hubs dev networking servers) or npm run start (to connect to your hubs cloud networking server).
• Visit you immer at https://localhost:8081, approve the certificate exception, get automatically forwarded to your hub at https://localhost:8080, approve another certificate exception, create a room, and you will be redirected to login or register with your immer.

Default immers server is https://localhost:8081, override with entry IMMERS_SERVER in hubs repo root folder .env file.

If working on immers server web client, run both npm run dev:client and npm run dev at the same time.