The Digital Telepresence Platform core implementing user account management, authentication, search, global directory, and other platform-wide services. https://digitaltelepresence.com/
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
Rob Colbert 2dcd95c74b large component and worker management and logging refactor 2 years ago
.vscode large component and worker management and logging refactor 2 years ago
app large component and worker management and logging refactor 2 years ago
client large component and worker management and logging refactor 2 years ago
config large component and worker management and logging refactor 2 years ago
docs doc updates 2 years ago
lib large component and worker management and logging refactor 2 years ago
ssl catching up with progress from Sites and Soapbox 2 years ago
supervisord catching up with progress from Sites and Soapbox 2 years ago
.env.default removing and refining into a base app that does much nothing 2 years ago
.gitignore integrate updates from LibertyLinks engine enhancements; new features for blog 2 years ago
.jshintrc scaffolding 2 years ago
LICENSE catching up with progress from Sites and Soapbox 2 years ago
NOTES.md catching up with progress from Sites and Soapbox 2 years ago
README.md doc updates 2 years ago
deploy integrate updates from LibertyLinks engine enhancements; new features for blog 2 years ago
dtp-base.code-workspace catching up with progress from Sites and Soapbox 2 years ago
dtp-webapp-cli.js large component and worker management and logging refactor 2 years ago
dtp-webapp.js large component and worker management and logging refactor 2 years ago
gulpfile.js moved to isolated ports 2 years ago
package.json Passport integrations for OAuth2 bearer, basic, and client password 2 years ago
push build and deployment automation 2 years ago
release catching up with progress from Sites and Soapbox 2 years ago
start-local Core feature progress 2 years ago
start-production integrate updates from LibertyLinks engine enhancements; new features for blog 2 years ago
stop-production integrate updates from LibertyLinks engine enhancements; new features for blog 2 years ago
update-deps.js large component and worker management and logging refactor 2 years ago
yarn.lock Passport integrations for OAuth2 bearer, basic, and client password 2 years ago

README.md

Digital Telepresence Base

The base project from which all others are forked when working with my framework and system. You don't have to start from this project at all. BUT, it can save you a lot of time by simply being a 100% compatible base on which you can build your apps and sites.

Requirements

The only qualified operated system for hosting a DTP Base suite is Ubuntu 20.04 LTS. It is acceptable to run it in a virtual machine for development and testing, but it should be run as close to bare metal as can be had for production environments.

You will need MongoDB and MinIO installed and running before you can start DTP Base web services.

  1. Install MongoDB
  2. Install MinIO

Install redis:

sudo apt-get install redis

Environment Configuration

On a new host or host image, copy .env.default to .env and edit it as necessary.

For password salt and service passwords, the uuidgen tool may be useful to help generate hard-to-guess passwords for use in a development environment. Something more sophisticated than a UUID should be used in production.

Install application dependencies by running Yarn. You should do this on initial install and after every update or git pull as dependencies do change often, become upgraded to new versions, receive security fixes, etc.

yarn

Starting DTP Base In Development Mode

  1. Make sure NODE_ENV is set to local
  2. Run ./start-local in a VS Code terminal, then rename that terminal to services.
  3. In a new VS Code terminal, run gulp and rename that terminal gulp.
  4. Open https://localhost:3000 in your web browser.

You can now make changes to program source code, and the environment will automatically respond, build, pack, and re-load things as needed depending on what you did and what's open/running.

DTP Base is a multi-tier web hosting engine built on:

Production Environment Information

It's impossible to give 100% generic advice here, but it all depends on how large your audience is and how much they use your website. Larger, more active audiences will require a different kind of production server deployment than smaller and less active audiences.

Generally, it's possible to stack all components on one host and operate a fast site for small-to-medium audiences. The size of the host may vary, but it's possible to keep the system stacked and handle quite a large audience.

Beyond a point, you'll need to start isolating services away from each other. Storage will want it's own system(s), MongoDB will want it's own systems (plural), Redis will want it's own system(s), and the Node.js components can each start to want their own system(s).

Once you start scaling horizontally, the host requirements change a little. You will need two networks and network interfaces per host. The production network to handle public requests; and a management network for handling IPC and data-sharing among the hosts themselves.

Some useful links for learning more about hosting MinIO:

Redis simply has many different documents to describe it's many different features and their requirements. I'd like to give you a summary page link, but it doesn't exist. This is that summary page. These are those links.

Software License

The DTP Base and the Phoenix Engine are licensed under the Apache 2.0 open source software license. See LICENSE for more information.