diff --git a/server-ip-sync.md b/server-ip-sync.md
new file mode 100644
index 0000000..8bb379e
--- /dev/null
+++ b/server-ip-sync.md
@@ -0,0 +1,77 @@
+## Requirements
+
+
+### Env file
+
+```python
+# template .env file
+token='ghp_<your gist token>'
+gist_id='abc...123'
+filename='<filename-in-gist>.txt'
+```
+
+### python requirements
+
+Install [python-dotenv](https://pypi.org/project/python-dotenv/)
+
+```
+# %pip install python-dotenv
+```
+
+These imports are necessary for reading and updating gists
+
+```python
+from dotenv import load_dotenv
+# in-built libraries
+import requests
+import json
+import os
+```
+
+
+### Reading `.env`
+
+```python
+# read env vars
+# S/O https://stackoverflow.com/a/61029741
+load_dotenv()
+token = os.getenv('token')
+gist_id = os.getenv('gist_id')
+filename = os.getenv('filename')
+```
+
+
+### write current machine ip address to gist file
+
+```python
+# fetch external ip address
+# S/O https://stackoverflow.com/a/36205547
+ip_addr = requests.get('https://api.ipify.org').content.decode('utf8')
+
+# request gist changes
+# S/O https://stackoverflow.com/a/65761251
+headers = {'Authorization': f'token {token}'}
+request_url = f'https://api.github.com/gists/{gist_id}'
+request_data = json.dumps({'files':{filename:{"content":ip_addr}}})
+
+r = requests.patch(
+    url=request_url,
+    data=request_data,
+    headers=headers)
+```
+
+
+### Read gist file content
+
+```python
+### fetch gist file content
+
+headers = {'Authorization': f'token {token}'}
+request_url = f'https://api.github.com/gists/{gist_id}'
+request_data = json.dumps({'files':{filename:{"content":ip_addr}}})
+r = requests.get(
+    url=request_url,
+    data=request_data,
+    headers=headers)
+gist_content = r.json()['files'][filename.strip()]['content']
+```