This repository contains all code used in the ioBroker Developer Portal at https://www.iobroker.dev
To install the application you can run npm install in these directories:
./express/frontend./express/backend
To build the application you can run npm build in these directories:
./express/frontend./express/backend
You may also use hot-reload of both the backend and frontend code. For this, you can start each applications with the respective command:
- frontend:
npm run start(open http://localhost:3000/ with your browser) - backend:
npm run watch(open http://localhost:8080/ with your browser)
Note: running the backend in watch mode will not use the frontend in hot-reload!
These instructions are only for development. DO NOT USE THIS IN A PRODUCTION ENVIRONMENT!
-
Create the two required Github OAuth apps in your account - see below
-
Create a file called
docker-compose.override.ymlin this root directory and configure all environment variables and the port to expose:
version: "3"
services:
express:
build: express
ports:
- "8080:8080"
environment:
ALLOW_CORS: 1
PORTAL_GITHUB_OAUTH_CLIENT_ID: 1234567890abcdefghij
PORTAL_GITHUB_OAUTH_CLIENT_SECRET: 123456e0a66c140657890abcdefghij7236c1406
CREATOR_GITHUB_OAUTH_CLIENT_ID: abcdefghij1234567890
CREATOR_GITHUB_OAUTH_CLIENT_SECRET: abcdefghij7236c1406123456e0a66c140657890
WEBLATE_ACCESS_TOKEN: AbCdEfGhIjKlMnOpQrStUvWxYz0123456789aBcD
SENTRY_AUTH_TOKEN: 01234567890abcdefghij7236c1406123456e0a66c140657890abcef01234567
watchtower:
command: none
mongo-express:
image: "mongo-express:latest"
restart: always
ports:
- "8088:8081"- In this root directory call
docker-compose pull && docker-compose up --build
The orchestration is done using docker-compose.
The docker image of the express application is hosted on GitHub, for this you need to login once with docker to the registry:
docker login docker.pkg.github.comAs the password you must use a personal access token for your GitHub account.
- Create a file called
docker-compose.override.ymlin this root directory and configure all environment variables and the port to expose:
version: "3"
services:
express:
ports:
- "80:8080"
environment:
PORTAL_GITHUB_OAUTH_CLIENT_ID: 1234567890abcdefghij
PORTAL_GITHUB_OAUTH_CLIENT_SECRET: 123456e0a66c140657890abcdefghij7236c1406
CREATOR_GITHUB_OAUTH_CLIENT_ID: abcdefghij1234567890
CREATOR_GITHUB_OAUTH_CLIENT_SECRET: abcdefghij7236c1406123456e0a66c140657890
WEBLATE_ACCESS_TOKEN: AbCdEfGhIjKlMnOpQrStUvWxYz0123456789aBcD
SENTRY_AUTH_TOKEN: 01234567890abcdefghij7236c1406123456e0a66c140657890abcef01234567
watchtower:
environment:
REPO_USER: "YourGitHubUserName"
REPO_PASS: "<personal access token (see above)>"- In this root directory call
docker-compose pull && docker-compose up
The following environment variables can be configured:
ALLOW_CORS: Allows the server to be accessed from another host (should only be used for development)PORTAL_GITHUB_OAUTH_CLIENT_ID: GitHub Client ID of your OAuth App that is used for general portal login (see below)PORTAL_GITHUB_OAUTH_CLIENT_SECRET: Client secret belonging to the above OAuth AppCREATOR_GITHUB_OAUTH_CLIENT_ID: GitHub Client ID of your OAuth App that is used to create and modify repositories (see below)CREATOR_GITHUB_OAUTH_CLIENT_SECRET: Client secret belonging to the above OAuth AppWEBLATE_ACCESS_TOKEN: Access token for a read-only Weblate userSENTRY_AUTH_TOKEN: Auth token for Sentry (requiresorg:readandproject:readscopes)
Two OAuth Apps are required to run this server:
- The general portal login application will always only ask for public data (and the e-mail address) and is used to authenticate the user, find his GitHub repositories and other publicly available information. The e-mail address might be used at a later time to send information about ioBroker development to the user (after consent!). The scope the OAuth request is
user:email. - Adapter Creator application will ask the user for much more permissons than the portal OAuth app. It is used to create repositories using the Adapter Creator and allow to modify code from this application. No interaction with the repository will ever be made without the user consenting at the given moment (there are no overnight jobs or anything like that). The scope the OAuth request is
repo.
Both applications must point to https://<your-server>/auth/ as the Authorization callback URL. For development this URL might be something like http://localhost:8080/auth/.
If you wish to use the Google Translate V3 API, you can provide valid credentials in a file called google-translate-credentials.json, so the Adapter Creator application can use larger quota for translations (which may result in costs).
For DEV, you can put it into the directory ./express/backend. The file will be copied by docker-compose into the express container and will be available to the web server.
For PROD, you can put it into the root directory of the project and then add the following volume to the express service in your docker-compose.override.yml:
volumes:
- ${PWD}/google-translate-credentials.json:/app/google-translate-credentials.jsonThe file can be generated on the Google Cloud Platform by creating a Service Account for Google Translate V3. See here for additional information. The expected format looks something like this:
{
"type": "service_account",
"project_id": "your-project-id-123456",
"private_key_id": "1234567890abcdef1234567890abcdef12345678",
"private_key": "-----BEGIN PRIVATE KEY-----\n...\n-----END PRIVATE KEY-----\n",
"client_email": "[email protected]",
"client_id": "123456789012345678901",
"auth_uri": "https://accounts.google.com/o/oauth2/auth",
"token_uri": "https://oauth2.googleapis.com/token",
"auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs",
"client_x509_cert_url": "https://www.googleapis.com/robot/v1/metadata/x509/your-app-name%40your-project-id-123456.iam.gserviceaccount.com"
}- Best Practices image: https://www.flickr.com/photos/barrydahl/6675297699 by Barry Dahl (CC BY 2.0)
- Code Review image: https://thenounproject.com/term/code-review/104097/ by Richard Slater (CC)
- Discord logo: By Source (WP:NFCC#4), Fair use, https://en.wikipedia.org/w/index.php?curid=50559581
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent