-
Notifications
You must be signed in to change notification settings - Fork 11
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Mark aws/k8s/digitalocean installation as deprecated (#949)
Co-authored-by: TheCatLady <[email protected]>
- Loading branch information
1 parent
fc6cc65
commit c748d97
Showing
34 changed files
with
406 additions
and
205 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
21 changes: 17 additions & 4 deletions
21
docs/getting-started/install-resoto/aws/web-installer/index.mdx
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file was deleted.
Oops, something went wrong.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,19 +1,90 @@ | ||
--- | ||
sidebar_label: "1. Install Resoto" | ||
sidebar_position: 1 | ||
sidebar_class_name: sidebar-install-resoto | ||
pagination_label: Install Resoto | ||
pagination_prev: getting-started/index | ||
pagination_next: getting-started/launch-resoto/index | ||
unlisted: false | ||
--- | ||
|
||
# Install Resoto | ||
|
||
Resoto can be deployed to [Amazon Web Services](./aws/index.mdx) or [DigitalOcean](./digitalocean/index.mdx), or installed via [Docker](./docker.mdx), [Kubernetes](./kubernetes.mdx), or [pip](./pip.mdx). | ||
[Docker](https://docker.com) images allow Resoto to be run in a loosely isolated environment called a [container](https://docs.docker.com/get-started/overview#containers). | ||
|
||
:::info | ||
:::tip | ||
|
||
Resoto consists of a number of distributed components that are intended to run 24/7 on a server. Running Resoto on a laptop will not provide a good user experience! | ||
Don't want to manage your own Resoto installation? Check out **[Fix](https://fix.tt)**, an all-in-one security dashboard built on top of Resoto. | ||
|
||
::: | ||
|
||
<DocCardList /> | ||
## Prerequisites | ||
|
||
- [Docker](https://docs.docker.com/get-started#download-and-install-docker) | ||
|
||
- [Docker Compose >= 1.29](https://docs.docker.com/compose/install) | ||
|
||
- At least 2 CPU cores and 8 GB of RAM | ||
|
||
:::note | ||
|
||
Resoto performs CPU-intensive graph operations. In a production setup, we recommend at least four cores and 16 gigabytes of RAM. See [Configuring Resoto Worker](../../reference/configuration/worker.mdx#multi-core-machines) for more information. | ||
|
||
::: | ||
|
||
## Directions | ||
|
||
1. Fetch the required files from the [`someengineering/resoto` GitHub repository](https://github.com/someengineering/resoto): | ||
|
||
```bash | ||
$ mkdir -p resoto/dockerV2 | ||
$ cd resoto | ||
$ curl -Lo docker-compose.yaml {{dockerComposeUrl}} | ||
$ curl -Lo dockerV2/prometheus.yml https://raw.githubusercontent.com/someengineering/resoto/{{repoBranch}}/dockerV2/prometheus.yml | ||
``` | ||
|
||
:::note | ||
|
||
By default, the `resotoshell` service bind-mounts the `~/resoto-downloads` directory to `/home/resoto/downloads` in the container. This allows you to access files outputted by Resoto Shell on the host. | ||
|
||
If you would like to change the download location from `~/resoto-downloads` to another directory, you can do so by editing the `docker-compose.yaml` file: | ||
|
||
```yaml | ||
resotoshell: | ||
... | ||
volumes: | ||
# highlight-next-line | ||
- ~/resoto-downloads:/home/resoto/downloads | ||
... | ||
``` | ||
|
||
::: | ||
|
||
2. Start the services defined in the `docker-compose.yaml` file: | ||
|
||
```bash | ||
$ docker-compose pull | ||
$ docker-compose up -d | ||
``` | ||
|
||
Upon execution of `docker-compose up -d`, Docker Compose will start all components and set up the system. This process takes approximately 1-3 minutes, depending on your machine and internet connection. | ||
|
||
:::note | ||
|
||
[Docker Compose V2 integrated compose functions in to the Docker platform.](https://docs.docker.com/compose/#compose-v2-and-the-new-docker-compose-command) | ||
|
||
In Docker Compose V2, the command is `docker compose` (no hyphen) instead of `docker-compose`. | ||
|
||
::: | ||
|
||
<VersionOnly allowed="current"> | ||
|
||
:::info | ||
|
||
Resoto publishes packages for both x86 and ARM architectures for stable releases, but `edge` versions are only available for x86. | ||
|
||
If you have an Apple Silicon or other ARM-based machine, please use the latest stable release (<LatestRelease /> or `latest`). | ||
|
||
::: | ||
|
||
</VersionOnly> |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.