This project leverages docker-compose to stand up a self-contained version of all Convergence Services to create a full Convergence environment. This project can be used as a local development environment or the basis of a production deployment using Docker Compose.
Convergence Labs provides several different channels for support:
- For assistance with large deployments or for deploying on systems like Kubernetes, use the Convergence Community Forum or contact us directly.
- Chat with us on the Convergence Public Slack.
- To report problems in this repository, use the Convergence Management Project.
If running in Linux, using Docker for Mac, or Docker for Windows, it is likely that your docker hostname will be "localhost". If using Docker Toolbox, or if you have installed docker in a Linux VM, it is possible that your docker hostname will be something else (for example an IP Address).
By default the .env file contains the following:
DOCKER_HOSTNAME=localhost
If you docker host is not localhost, update this setting to point to the right host.
You will also need to edit the default nginx config file config/nginx/default.conf to set the server_name to the proper hostname. Just do a find and replace of localhost to your hostname.
Please note that this installation contains a self-signed SSL Certificate that will need to be accepted. Also note that the hostname may not be localhost (as discussed above).
- Dev Launchpad URL:
https://<hostname>/ - Admin Console:
https://<hostname>/console/ - REST API Endpoint:
https://<hostname>/api/rest/ - Web Socket Endpoint:
https://<hostname>/api/realtime/
When the environment starts up, it will create a data directory where all persistent data from the services will be stored. You can tear down and recreate the environment and data will still persist in the data directory. If you would like to start from scratch simply delete the data directory.
The docker compose project uses NGINX as a reverse proxy to host HTTP endpoints. The configuration comes with self-signed certificates configured for the nginx reverse proxy. The certificates are located in the config/nginx/ssl directory. If you want to use your own certs simply replace the server.crt and server.key files in that directory. Refer to the nginx documentation for more information.
Within the config directory you'll see a few different sets of configurations for the various containers (see below). You'll probably be most interested in the convergence and nginx directories.
You can configure the default namespace, domain, and administration user (to log into the administration console) in config/convergence/convergence-server.conf.
If you're spinning up all the containers defined in the docker-compose.yml in this repository on a single cloud compute instance, make sure this instance has AT LEAST 4GB RAM (and preferably 6GB+) available. Otherwise you will see errors in the server and/or orientdb.
You probably only want to provide public access to the API endpoints listed above, and lock down everything else.
orientdb: Provides the core database for Convergencecluster-seed: The seed node of the Convergence clusterserver: The Convergence Serveradmin-console: The Administration Console user interfaceproxy: An nginx reverse proxy for the whole Convergence environment
To start up the entire environment issue the following command
docker-compose up
To start the environment the background run:
docker-compose up -d
To start up only a single container use:
docker-compose up <container-name>
If you change a container, docker up will undeploy the current one and re-deploy the new one if there are any changes.
To start up only a single container use:
docker-compose stop <container-name>
To tear down the environment use:
docker-compose down
If all else fails, post your problem at https://forum.convergence.io and the team will help you out.
I'm getting
access deniederrors
We have seen periodic issues where files and directories are owned by root as opposed to the default user. Just run sudo chown -R <user> <directory> as appropriate in the config or data subdirectories.