Maybe you want to run Misakey yourself in order to test it:
⚠️ The system is considered not ready for self-hosting production yet. Some breaking changes may apply since the system is still a work in progress. For our SAAS solution https://app.misakey.com we mitigate the breaking changes. But we cannot handle it if you have installed Misakey on your infrastructure. Updates are quite important when it concerns security, so feel free to contact us to inform us you are using it, so we can communicate with you.
In this tutorial, you will get to run the Misakey's stack locally in 5 min. After that you will be able to start hacking around.
- Python3 (with Pip)
- Docker compose
We grouped all the tools required to run the app locally in a project called test and run.
Clone the repository with
git clone firstname.lastname@example.org:misakey/test-and-run.git.
Install the CLI:
- Go to the
- Make sure you have
pipfor Python 3
pip install -e .
misacli CLI must be used in the root directory of the project.
Run the command
misacli init and follow the instructions.
The others commands are described in the CLI help (
Example: To run the whole application, run
misacli run app.
Open your web browser and go to https://app.misakey.com.local.
You will have to accept self-signed certificates (3 times): we decided to use SSL even in local development environement to be closer to a real-world environment.
Then you can play with the demo application: using the auth, creating data channels and chatting through them…
From there, you can create your own app using the SSO and the other bricks of the system.
You can find a more complete references of the APIs and the usage of the stack in dedicated guides.
Misakey tech is distributed as a set of Docker images. This makes it easy to deploy it in various environments.
- A PostgreSQL Database.
- A Redis database.
- An Amazon S3 storage.
- An Amazon SES service for sending emails.
- A Datadog account and agents to monitor your infrastructure
Running on docker-compose is quite easy. The recommended architecture is the same as the one described in guide for running locally the solution.
You can take inspiration from the
docker-compose.yml file in the guide and adjust it to your needs:
- Using your DB, Cache, S3 and email providers instead of local ones
- Managing your configuration files
- Using a
docker-composefile version 3 to have something more production oriented (and being able to manage redundancy for instance)
This section is a work in progress. We know we should add information about deployment and provide helm repos.
If you want to deploy on Kubernetes, we provide some helm charts alongside our Docker images to make it easy to deploy on your cluster.
You can check on every code repository to get the dedicated helm chart to be able to deploy all services. The complementary information (config, secrets, ...) are available on each repository(frontend, backend/api, backend/gateway).
Before you can interact with Misakey tech, you have to create an authentication client to authenticate your users or give access to another service to your user data.
Misakey uses ORY Hydra as an OpenID server. To create a client, you have to send a
POST request to
http://your-hydra-admin-url:4445/clients with the following body: