mirror of
https://github.com/planetmint/planetmint.git
synced 2025-03-30 15:08:31 +00:00
a34862b8bc
* added smaller logos fixed reference issue Signed-off-by: Jürgen Eckel <juergen@riddleandcode.com> * fixed some erros and typos Signed-off-by: Jürgen Eckel <juergen@riddleandcode.com> * added cryptoconditions reference to the subproject Signed-off-by: Jürgen Eckel <juergen@riddleandcode.com>
65 lines
2.0 KiB
Markdown
65 lines
2.0 KiB
Markdown
<!---
|
|
Copyright © 2020 Interplanetary Database Association e.V.,
|
|
Planetmint and IPDB software contributors.
|
|
SPDX-License-Identifier: (Apache-2.0 AND CC-BY-4.0)
|
|
Code is Apache-2.0 and docs are CC-BY-4.0
|
|
--->
|
|
|
|
# Deploy a Machine for Your Planetmint Node
|
|
|
|
The first step is to deploy a machine for your Planetmint node.
|
|
It might be a virtual machine (VM) or a real machine, for example,
|
|
an EC2 on AWS or a droplet on Digital Ocean.
|
|
If you follow this simple deployment template, all your node's
|
|
software will run on that one machine.
|
|
|
|
We don't make any assumptions about _where_ you run the machine.
|
|
It might be in Azure, AWS, your data center or a Raspberry Pi.
|
|
|
|
## IP Addresses
|
|
|
|
The following instructions assume all the nodes
|
|
in the network (including yours) have public IP addresses.
|
|
(A Planetmint network _can_ be run inside a private network,
|
|
using private IP addresses, but we don't cover that here.)
|
|
|
|
## Operating System
|
|
|
|
**Use Ubuntu 18.04 Server or above versions as the operating system.**
|
|
|
|
Similar instructions will work on other versions of Ubuntu,
|
|
and other recent Debian-like Linux distros,
|
|
but you may have to change the names of the packages,
|
|
or install more packages.
|
|
|
|
## Network Security Group
|
|
|
|
If your machine is in AWS or Azure, for example, _and_
|
|
you want users to connect to Planetmint via HTTPS,
|
|
then you should configure its network security group
|
|
to allow all incoming and outgoing traffic for:
|
|
|
|
* TCP on port 22 (SSH)
|
|
* TCP on port 80 (HTTP)
|
|
* TCP on port 443 (HTTPS)
|
|
* Any protocol on port 26656 (Tendermint P2P)
|
|
|
|
If you don't care about HTTPS, then forget about port 443,
|
|
and replace port 80 with port 9984 (the default Planetmint HTTP port).
|
|
|
|
## Update Your System
|
|
|
|
SSH into your machine and update all its OS-level packages:
|
|
|
|
```
|
|
sudo apt update
|
|
sudo apt full-upgrade
|
|
```
|
|
|
|
## DNS Setup
|
|
|
|
* Register a domain name for your Planetmint node, such as `example.com`
|
|
* Pick a subdomain of that domain for your Planetmint node, such as `bnode.example.com`
|
|
* Create a DNS "A Record" pointing your chosen subdomain (such as `bnode.example.com`)
|
|
at your machine's IP address.
|