Merge branch 'main' of github.com:bpmct/to-railway into main

Author: bpmct

guides/heroku.md

@@ -1,3 +1,41 @@
+# Guide: Launching code-server on Heroku
+
 ![code-server and railway.app](../img/code-server-railway.png)
 
-## Guide: Launching code-server on Heroku
+[Railway](https://railway.app) is a new cloud development platform! ☁️ Use Railway + code-server to get a dev environment that you can access from any device.
+
+## Step 1: Click to deploy [![Deploy on Railway](https://railway.app/button.svg)](https://railway.app/new?template=https%3A%2F%2Fgithub.com%2Fbpmct%2Fcode-server-railway&envs=PASSWORD%2CGIT_REPO&PASSWORDDesc=Your+password+to+log+in+to+code-server+with&GIT_REPODesc=A+git+repo+to+clone+and+open+in+code-server+%28ex.+https%3A%2F%2Fgithub.com%2Fcdr%2Fdocs.git%29)
+
+---
+
+## Step 2: Configure & launch your environment
+
+![railway launch environment screen](../img/launch-railway.gif)
+
+You'll need to make a new repository which will contain your code-server configuration. If you push changes to this repo (to install NodeJS, for example), it will re-deploy code-server.
+
+You also need to specity a `PASSWORD` and a `GIT_REPO` to clone in your environment :)
+
+## Step 3: Modify your environment to add additional tools
+
+![railway repo](../img/railway-connected.png)
+
+1. In Railway, go to `Deployments -> Triggers` to see your source repo.
+1. Open the source repo in GitHub and edit the `Dockerfile`
+1. Add some custom tools (like NodeJS) and commit to the main branch:
+
+   ```Dockerfile
+   # You can add custom software and dependencies for your environment here. Some examples:
+
+   # RUN code-server --install-extension esbenp.prettier-vscode
+   # RUN sudo apt-get install -y build-essential
+   # RUN COPY myTool /home/coder/myTool
+
+   # Install NodeJS
+   RUN sudo curl -fsSL https://deb.nodesource.com/setup_15.x | sudo bash -
+   RUN sudo apt-get install -y nodejs
+   ```
+
+1. Head back to Railway and notice a new deployment was created. After it has completed, you can use these tools in your environment.
+
+1. (Optional): [Configure rclone](https://github.com/bpmct/deploy-code-server/tree/main/deploy-container#-persist-your-filesystem-with-rclone) so that you can save your VS Code config and files without commiting

guides/railway.md

@@ -1,9 +1,9 @@
-![code-server and railway.app](../img/code-server-railway.png)
-
-## Guide: Launching code-server on railway.app
+# Guide: Launching `code-server` on railway.app
 
 [Railway](https://railway.app) is a new cloud development platform! ☁️ Use Railway + code-server to get a dev environment that you can access from any device.
 
+![code-server and railway.app](../img/code-server-railway.png)
+
 ## Step 1: Click to deploy [![Deploy on Railway](https://railway.app/button.svg)](https://railway.app/new?template=https%3A%2F%2Fgithub.com%2Fbpmct%2Fcode-server-railway&envs=PASSWORD%2CGIT_REPO&PASSWORDDesc=Your+password+to+log+in+to+code-server+with&GIT_REPODesc=A+git+repo+to+clone+and+open+in+code-server+%28ex.+https%3A%2F%2Fgithub.com%2Fcdr%2Fdocs.git%29)
 
 ---