add instructions to build a quick docker image for dev

Author: Bilb

.dockerignore

@@ -0,0 +1,9 @@
+.git
+.gitignore
+Dockerfile*
+DockerFile*
+docker-compose*
+README.md
+LICENSE
+.vscode
+

docker/DockerFile.dev

@@ -0,0 +1,26 @@
+# check docker/Readme.md
+
+FROM ubuntu:impish
+RUN apt update
+RUN apt upgrade -y
+
+RUN apt-get install -y locales && locale-gen en_US.UTF-8
+ENV LANG='en_US.UTF-8' LANGUAGE='en_US:en' LC_ALL='en_US.UTF-8'
+
+RUN DEBIAN_FRONTEND=noninteractive TZ=Etc/UTC apt -y install curl build-essential libssl-dev pkg-config lsb-release
+RUN curl -so /etc/apt/trusted.gpg.d/oxen.gpg https://deb.oxen.io/pub.gpg
+RUN echo "deb https://deb.oxen.io $(lsb_release -sc) main" | tee /etc/apt/sources.list.d/oxen.list
+RUN apt update
+RUN apt -y install python3-oxenmq python3-oxenc python3-pyonionreq python3-coloredlogs python3-uwsgidecorators python3-flask python3-cryptography python3-nacl python3-pil python3-protobuf python3-openssl python3-qrencode python3-better-profanity python3-sqlalchemy python3-sqlalchemy-utils uwsgi-plugin-python3
+
+
+# just add an alias to the pysogs-start command
+RUN echo -e '#!/bin/bash\nuwsgi docker/uwsgi-sogs-docker.ini' > /usr/bin/pysogs && \
+    chmod +x /usr/bin/pysogs
+
+
+RUN mkdir session-pysogs
+WORKDIR session-pysogs
+
+
+EXPOSE 80

docker/Readme.md

@@ -0,0 +1,47 @@
+# Docker for pysogs development
+
+The file DockerFile.dev is specifically made for development if you are not running linux.
+It lets you create a docker running linux and the pysogs in it even if you are running Macos or Windows.
+It creates a docker container with the content of this git reposotiry mounted.
+Basically, whatever you edit in this repository will be represented on the docker container. So when you run the container, it will run your code.
+
+## Build the container image
+
+You need to have docker installed on your computer. Follow the docker documentation for your system first.
+Once you can run the hello world from github you should be fine
+
+```
+docker run hello-world # this command should print "Hello from Docker!"
+
+```
+
+Then, build the container image for pysogs-dev as
+
+```
+git clone [email protected]:oxen-io/session-pysogs.git
+cd session-pysogs
+sudo docker build . -f docker/DockerFile.dev -t pysogs-dev
+```
+
+Before you can run the container you need to set the base config. You can do so by copying `sogs.ini.sample` to `sogs.ini` and replacing the line with base_url with `base_url = http://localhost`.
+
+Next,
+You can run and attach to the container with
+
+```
+sudo docker run -i -p 8080:80 -v $PWD:/session-pysogs -t pysogs-dev:latest
+```
+
+To start the pysogs once you have a shell in the container do:
+
+```
+pysogs
+```
+
+To create a room once you have a shell inside the container do
+
+```
+python3 -msogs --add-room fishing --name "Fish Talk"
+```
+
+More doc at https://github.com/oxen-io/session-pysogs/blob/dev/administration.md#sogs-administration

docker/uwsgi-sogs-docker.ini

@@ -0,0 +1,30 @@
+# uwsgi configuration for listening directly on port 80; this is the simplest setup, but is less
+# flexible and slightly less performant than proxying through a front-end server (e.g. nginx) and
+# cannot be used if anything else on the system always wants to serve any HTTP traffic.
+#
+# Note that this configuration is meant for setups where sogs will be directly serving public HTTP
+# requests, and is sub-optimal for handling proxied requests; for that see the
+# uwsgi-sogs-proxied.ini configuration instead.
+
+# Configuration requires:
+# - change the chdir= to the path where you want to write the sogs data files (database, uploads,
+#   keys, etc.)
+#
+# - change uid= and gid= values to the system user/group names that the script should run as.  DO
+#   NOT RUN AS root!  That path that you specify for `chdir=` should be owned by this user/group.
+#
+# - tweak the `processes` argument, if desired and you have more than 2 cores and expect a very busy
+#   SOGS.
+#
+# - if using uwsgi in vassal mode then put the configuration file into /etc/uwsgi/vassals
+#
+[uwsgi]
+chdir = /session-pysogs
+uid = root
+gid = root
+plugins = python3,http
+processes = 2
+enable-threads = true
+http = :80
+mount = /=sogs.web:app
+mule = sogs.mule:run