This is the public repository of the Sovereign Stack bash scripts. https://www.sovereign-stack.org

Go to file

Derek Smith 6948856bc9 Bump nginx version and other updates.		2022-11-15 16:00:08 -05:00
.vscode	Whitespace, formatting, control udpates.	2022-08-15 09:37:13 -04:00
certs	Moved files	2022-05-24 14:14:53 -04:00
deployment	Bump nginx version and other updates.	2022-11-15 16:00:08 -05:00
staging	Updated BTCPAY_ALT_NAMES	2022-11-02 14:54:02 -04:00
.gitignore	Various refactors. Separting out VMs.	2022-08-24 10:11:50 -04:00
51-trezor.rules	Initial Commit	2021-12-25 13:43:01 -05:00
NOTES	Multilanguage ghost and other updates.	2022-09-28 13:59:01 -04:00
README.md	Working on btcpay backup/restore.	2022-10-26 21:41:14 -04:00
cluster.sh	Improve cluster init script.	2022-11-05 19:51:58 -04:00
defaults.sh	Bump nginx version and other updates.	2022-11-15 16:00:08 -05:00
deploy.sh	Bump nginx version and other updates.	2022-11-15 16:00:08 -05:00
domain_env.sh	Removed all AWS functionality. Big day.	2022-10-30 22:24:25 -04:00
install.sh	Improve cluster init script.	2022-11-05 19:51:58 -04:00
migrate.sh	Before removing AWS functionality.	2022-10-30 22:09:44 -04:00
reset.sh	Suppress error messages and timing.	2022-10-29 11:34:17 -04:00
reset_env.sh	Minor formatting and stability updates.	2022-10-30 12:59:24 -04:00
show_lxc.sh	Various refactors. Separting out VMs.	2022-08-24 10:11:50 -04:00

README.md

Documentation

The Sovereign Stack scripts in this repository are meant to be cloned to and executed from your management machine.

You can update Sovereign Stack scripts on your management machine by running git pull --all --tags. Generally, you want to use ONLY signed git tags for your deployments. Use git checkout v0.1.0 for example to switch to a specific version of Sovereign Stack. The scripts check to ensure that the code you're running on your management machine is GREATER THAN OR EQUAL TO the version of your deployments (TODO). The scripts work to bring your old deployments into line with the current Sovereign Stack version.

Once your managent machine checkedout a specific version of Sovereign stack, you will want to run the various scripts against your remotes. But before you can do that, you need to bring a bare-metal Ubuntu 22.04 cluster host under management (i.e., add it as a remote). Generally speaking you will run ss-cluster to bring a new bare-metal host under management of your management machine. This can be run AFTER you have verified SSH access to the bare-metal hosts. The device SHOULD also have a DHCP Reservation and DNS records in place.

After you have taken a machine under management, you can run ss-deploy it. All Sovereign Stack scripts execute against your current lxc remote. (Run lxc remote list to see your remotes). This will deploy Sovereign Stack software to your active remote in accordance with the various cluster, project, and site defintions. These files are stubbed out for the user automatically and documetnation guides the user through the process.

It is the responsiblity of the management machine (i.e,. system owner) to run the scripts on a regular and ongoing basis to ensure active deployments stay up-to-date with the Sovereign Stack master branch.

By default (i.e., without any command line modifiers), Sovereign Stack scripts will back up active deployments resulting in minimal downtime. (zero downtime for Ghost, minimal for Nextcloud/Gitea, BTCPAY Server).

All other documentation for this project can be found at the sovereign-stack.org.