diff --git a/docs/server-side.md b/docs/server-side.md new file mode 100644 index 0000000..2ac884c --- /dev/null +++ b/docs/server-side.md @@ -0,0 +1,24 @@ + +--- +title: Running abra on the server +--- + +## Why? + +If you're on an environment where it's hard to run Docker, or command-line programs in general, you might want to install `abra` on a server instead of your local computer. + +To install `abra` on a different server than you'll be hosting your apps, just follow [getting started guide](/overview/) as normal. + +If you want to install `abra` on the same server, there's one change. + +Instead of providing your SSH connection details when you run `abra server add ...`, just use `default`: + +``` +abra server add default +``` + +!!! note "Technical details" + + This will tell `abra` to look at the Docker system running on the server, instead of a remote one. + +Make sure to back up your `~/abra/` directory on the server, or put it in version control, as well as other files you'd like to. diff --git a/mkdocs.yml b/mkdocs.yml index 0791a57..304ff7f 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -50,6 +50,7 @@ nav: - Back-up and restore an app: backup-restore.md - Scale an app up to handle more traffic: scale.md - Roll an app back to a previous version: rollback.md + - Running abra on the server: server-side.md - Strategy: strategy.md - Bike map: bikemap.md - Troubleshooting: troubleshooting.md